To create a punch entry with output directed to a disk file, select:
1. Option 1 (Create a new table) or option 3 (Add entries to an existing table) on the mian menu
2. Option 3 (Punch) on the entry menu 3. Option 2 (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 entered Punch and Table entry name on the entry menu and Disk file on the output menu, the following displays are presented.
The first display allows you to define the characteristics of the file you want created. You can supply such information as the file name and type of file.
MSRJE CONTROL TABLE UTILITY FORMFILE RESFORM7 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 name of the file that is to be created by MSRJE. MSRJE is the default. The file is labeled xxxxxxnn, where xxxxxx is the value specified for this prompt, and nn is 00 if the data is to be added to an existing file, or nn is equal to the punch file sequence number as specified on display 36.0 during MSRJE configuration.
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
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, will be 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 parameter, 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 file will be located on a remote system. Unused file blocks cannot be released on remote systems.
The next display allows you to specify additional characteristics of the file, such as the initial allocated disk space for the file and whether the file can later be
expanded.
MSRJE CONTROL TABLE UTILI'l'Y FORMFILE RESFORM7 Create an MSR.JE 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-Previous menu, save entry Cmd7-End, 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.
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 fde 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 RESFORM7 Create an MSRJE forms control table punch entry
Starting position of the key Length of the key . . Allow duplicate keys?
1-4096 1-120 1 . N,Y N
Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry
(c) 1983 IBM Corp.
Starting position of the key: Specify the first position of the key within the record, which can be any value from 1 through 4096. The default is 1.
Length of the key: Specify the number of bytes in the key. Any value from 1 through 120 is valid. The default is 1.
Note: The value specified for Starting position of the key plus the value specified for Length of the key minus 1 must be less than or equal to the defined record length.
Allow duplicate keys?: Specify whether more than one record can have the same key value within the file. N (No), the default, specifies that duplicate keys are not allowed. Y (Yes) specifies that duplicate keys are allowed.
If N is specified, duplicate key errors may occur since the host system can send duplicate header or trailer records to System/36.
This completes the definition for a print entry with output to a disk file. The entry
menu is displayed. '