To create a punch entry with output directed to a compressed disk file for a disk file, select:
1. Option 1 (Create a new entry) or option 3 (Add entries to an existing table) on the main menu
2. Option 3 (Punch) on the entry menu
3. Option 5 (Compressed disk file for a disk file) on the output menu If you are updating an existing entry (option 2 on the main menu), the current values are presented for the named entry on each of the displays. You can change any of those values. After you have selected Punch, and Table entry name on the entry menu, and compressed disk file for a disk file on the output menu, the following displays are presented.
MSRJE CONTROL TABLE UTILITY FORMFILE RESFORM8 Create an MSRJE forms control table compressed disk file entry
Optional-*
Name of the file to be created MSRJE
User ID . . . . MSRJE
Number of blocks to be reserved 1-560872 60
Number of blocks to extend the file 0-560872 10 Preferred disk location A1,A2,A3,A4,block number A1 *
Save the file in case of error? Y,N Y
Add output to an existing file? N,Y N
Free unused file blocks? Y,N Y
Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry
CORP IBM Corp. 1986
Name of the file to be created: Specify the first 6 characters of the name of the file to be created when punch output is written to a compressed disk file. MSRJE is the default name.
The file will be named as follows:
xxxxxxnn where:
xxxxxx
nn
is the value you specify for the Name of the file to be created prompt.
is the punch file sequence number (as specified on display 36.0 during MSRJE configuration) if the Add output to an existing file? prompt is specified as N (No).
or
nn is 00 if the Add output to an existing file? prompt is Y (Yes).
User ID: Specify the user ID to be used when output is being written to disk and resource security is active. The user ID can be from 1 to 8 characters; the default is MSRJE.
Number of blocks to be reserved: Specify, in decimal, the number of blocks that are to be initially allocated for this file. Any number from 1 to 560872 is valid, but the specification cannot exceed the amount of available disk storage. The default is 60 blocks.
Number of blocks to extend the file: Specify the number of blocks by which the file should be enlarged if the file becomes full. If 0 is specified, the file cannot be extended (enlarged). Any decimal value from 0 to 560872 can be specified;
the default is 10.
Preferred disk location: Specify either the disk on which you want the file placed or the block number at which the file should begin. The file is placed on the:
First disk if you specify A 1, the default
• Second disk if you specify A2
• Third disk if you specify A3
• Fourth disk if you specify A4
Save the file in case of error?: Specify whether you want the data written to the file to be saved if an error occurs before the file is closed. Y (Yes), the default, specifies that if an error occurs before all data has been written to the file, the system will save the data already written to the file. N (No) specifies that the data already written will be lost if an error occurs before the file has been closed.
Note: If you wish to add data to an existing file (.~ee the next prompt), you should specify Y for this prompt. If you specify N and an error occurs, the entire file, including the data previously in the file, is deleted.
Add output to an existing file?: Specify whether you want the punch data received for this entry to be added to an existing compressed disk file. Y (Yes) specifies that you want the data added to file xxxxxxOO, where xxxxxx is the value specified for the Name of the file to be created prompt or MSRJE. N (No), the default, specifies that you want a new file created, and that file will be named xxxxxxnn, where xxxxxx is the value specified for the Name of the file to be created prompt, and rm is the punch file sequence number.
If you specify Y and a file by the specified name cannot be found, a new file will be created using that name.
Notes:
I. Only one device can use the file at one time.
2. If you specify yes to this prompt and specified no to prompt 7, Keep host data sets together on the MSRJE Printer/Punch Attributes display (display 36.0), the yes on this prompt will override the no on display 36.0.
Free unused file blocks?: Specify whether blocks that are not used by the file are to be released for use by other files. Specify Y (Yes), the default, or N (No).
Specify N (No) if the file will be located on a remote system. Unused file blocks cannot be released on remote systems.
Once you have completed the definition for the compressed disk file, you define the characteristics of a data file so that the RJFILE utility (see Chapter 6) can convert the compressed file to a data file usable by your programs. The following sequence of displays is presented.
MSRJE CONTROL TABLE UTILITY FORMFILE RES FORMS Create an MSRJE forms control table punch entry
Optional-*
Name of the file to be created MSRJE
User ID MSRJE
Procedure name *
Library name #LIBRARY
Type of file to be created S,D,I S
Save the file in case of error? Y,N Y
Add output to an existing file? N,Y N
Free unused file blocks? . . . . Y,N Y
Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry
(c) 1983 IBM Corp.
Name of the file to be created: Specify the first 6 characters of the name of the file that is to be created by MSRJE. MSRJE is the default name.
The file will be named as follows:
xxxxxxnn where:
xxxxxx
nn
is the value you specify for the Name of the file to be created prompt.
is the punch file sequence number (as specified on display 36.0 during MSRJE configuration) if the Add output to an existing file?
prompt is specified as N (No) or
nn is 00 if the Add output to an existing file? prompt is Y (Yes).
User ID: When resource security is active on System/36, specify the user ID that is to be used when punch data is written to disk and when a procedure is started by MSRJE. The ID specified can be from 1 through 8 characters.
Procedure name: Specify the name of a System/36 procedure, if any, that should be started by MSRJE or RJFILE after this punch data stream has been received.
When running RJFILE, if the procedure contains a LOAD OCL statement, the procedure should also contain a LIBRARY OCL statement with the name of the library that contains the program that is to be loaded. If the procedure does not contain a library statement, the program that is to be loaded must be located in the system library.
Library name: Specify the name of the System/36 library that contains the procedure specified for the previous prompt.
Type of file to be created: Specify whether you want MSRJE to create a sequential file (S, the default), a direct file (D), or an indexed file (I).
Save the file in case of error?: Specify whether you want the data written to the file to be saved if an error occurs before the file is closed. Y (Yes), the default, specifies that if an error occurs before all data has been written to the file, the system will save the data already written to the file. N (No) specifies that the data already written will be lost if an error occurs before the file has been closed.
Note: If you wish to add data to an existing file (see the next prompt), you should specify Y for this prompt. If you specify N and an error occurs, the entire file, including the data previously in the file, is deleted.
Add output to an existing file?: Specify whether you want the punch data received for this entry to be added to an existing disk data file. Y (Yes) specifies that you want the data added to file xxxxxxOO, where xxxxxx is the value specified for the Name of the file to be created prompt. N (No), the default, specifies that you want a new file created, and that file will be named xxxxxxnn, where xxxxxx is the value specified for the Name of the file to be created prompt, and nn is the punch file sequence number.
If you specify Y and a file by the specified name cannot be found, a new file will be created using that name.
Notes:
1. Only one device can use the file at one time.
2. If you specify yes to this prompt and specified no to prompt 7, Keep host data sets together on the MSRJE Printer/Punch Attributes display (display 36.0), the yes on this prompt will override the no on display 3 6. 0.
Free unused file blocks?: Specify whether blocks that are not used by the file can be released for use by other files. Specify Y (Yes), the default, or N (No).
Specify N (No) if the disk file will be located on a remote system. Unused file
MSRJE CONTROL TABLE UTILITY FORMFILE RESFORM8 Create an MSRJE forms control table punch entry
Optional-*
Number of blocks to be reserved . . 1-560872 60 Number of blocks to extend the file 0-560872 10 Preferred disk location A1,A2,A3,A4,block number A1 *
Record length in bytes 1-4096 80
Delete capable file? . . . N,Y N
Cmd3-Save entry, display entry menu cmd7-End of job, cancel entry
COPR IBM Corp. 1986
Number of blocks to be reserved: Specify, in decimal, the number of blocks that are to be initially allocated for this file. Any number from 1 to 560872 is valid, but the specification cannot exceed the amount of available disk storage. The default is 60 blocks.
Number of blocks to extend the file: Specify the number of blocks by which the file should be enlarged if the file becomes full. If 0 is specified, the file cannot be extended (enlarged). Any decimal value from 0 to 560872 can be specified;
the default is 10.
Preferred disk location: Specify either the disk on which you want the file placed or the block number at which the file should begin. The file is placed on the:
• First disk if you specify Al, the default
• Second disk if you specify A2
• Third disk if you specify A3
• Fourth disk if you specify A4
Al, A2, A3, and A4 are only preferred locations. If the disk you specify is full or does not exist, the file is placed wherever there is room.
A block number can be any 6-digit number less than 560872. Your file is placed at the block location you specify only if that location is available.
Record length in bytes: Specify the size of the records that are to be written to the file. MSRJE always receives 80-character records. If the value you specify for the Record length in bytes prompt is not 80, MSRJE restructures the data into records of the size you specify. For example, if you specify 60 for the Record length in bytes prompt, three 80-character records received by MSRJE will be written to the file you are defining as four 60-character records. If you specify 160 for the Record length in bytes prompt, every two 80-character records received by MSRJE will be written to the file you are defining as one 160-character record.
Normally, the record length for a punch file is 80 or 96 bytes. The default record length for punch data directed to a data file is 80 bytes.
Delete capable file? Specify whether the file being created is to be a delete-capable file. Y specifies that it is; N, the default, specifies that it is not
delete-capable.
If you specified a file type of S (sequential) or D (direct) for the Type of file to be created prompt, this completes your definition. The entry menu is displayed. If you specified a file type of I (indexed), you must complete one more display.
MSRJE CONTROL TABLE UTILITY FORMFILE RESFORM8 Create an MSRJE forms control table punch entry
Starting position of the key 1-4096
Length of the key . . 1-120
Allow duplicate keys? . N,Y N
Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry
(c) 1983 IBM Corp.
/