In this section: |
Extract files save lines of user output generated during a FOCUS session. If you do not allocate these files, FOCUS allocates HOLD, SAVE, SAVB, and HOLDMAST files. You must explicitly allocate the files described in Extract Files That You Allocate: LET, LOG, POST, Dialogue Manager Output Files.
How to: |
A HOLD file is a sequential data source that contains the results of a report request. To save report output in a HOLD file, you must execute the HOLD command.
Data for a temporary HOLD file is written to a data set whose DDNAME is HOLD or was specified with an AS phrase. This data set is a sequential file. FOCUS provides the DCB parameters in accordance with the record length of the report it is about to store. The DCB BLKSIZE parameter is automatically calculated. (To change this default, specify the SET BLKCALC command as described in the Developing Applications manual.) The layout of the HOLD file can be obtained from within FOCUS by issuing the FOCUS ? HOLD command.
Typical allocations for a HOLD file in TSO and batch are:
ALLOC F(HOLD) SP(20 10) CYL //HOLD DD UNIT=SYSDA,SPACE=(CYL,(20,10))
If you have FOCUS store another report in the same HOLD file, it will overwrite the previous one, and FOCUS will assign new DCB attributes in accordance with the new report's records. For example, if you specify HOLD AS MASTER, it will overwrite your Master File. (If you do want to save the file, we recommend you make it part of the standard FOCUS CLIST and allocate it as a permanent data set.)
To save report output in a HOLD file, execute the HOLD command
HOLD [AS ddname]
where:
Is the sequential data set in which FOCUS saves the report output. FOCUS stores a Master File describing the report output in a member of the temporary data set allocated to DDNAME HOLDMAST. If you omit the AS ddname option, the DDNAME defaults to HOLD. The default allocation is five primary and five secondary cylinders.
How to: |
A SAVB contains the results of a report request with all numeric report fields in binary format. The file cannot be printed. Also, all character fields are padded with spaces to a multiple of 4 bytes.
SAVB [AS ddname]
where:
Is the name under which FOCUS allocates a temporary sequential data set.
FOCUS dynamically allocates a temporary sequential data set under DDNAME SAVB or a DDNAME you supply with the AS ddname option. FOCUS allocates five cylinders for primary space and 10 cylinders for secondary space. Record format is variable blocked with record length and block size dependent on the record size. Once DCB attributes are assigned, they remain in effect for the duration of the session, even if another SAVB is issued for the same file. To keep the file, use the DYNAM COPY command.
How to: |
A SAVE file contains the results of a report request with the external character format equivalent to SAVB. The command format and allocations are the same as SAVB. However, the numbers are printable EBCDIC characters, and no padding takes place.
SAVE [AS ddname]
where:
Is the name under which FOCUS allocates a temporary sequential data set.
When FOCUS HOLD files are created, either under the default name HOLD or under a specified name (for example, HOLD AS MYNAME), the description is written into the data set whose DDNAME is HOLDMAST. This data set is exactly like a MASTER data set except that FOCUS creates the members.
Note: If you are using an adapter to create a relational table using HOLD, FOCUS also creates an Access File allocated to DDNAME HOLDACC. The following rules for HOLDMAST also apply to HOLDACC.
If HOLDMAST is not allocated when a HOLD file is created, FOCUS will allocate HOLDMAST as a partitioned data set with five primary and 10 secondary tracks.
Whenever FOCUS needs the description of a data source, it first searches DDNAME MASTER. If the member is not found, it then searches DDNAME HOLDMAST.
Typical allocations for a temporary HOLDMAST file in TSO and batch are:
ALLOC F(HOLDMAST) SP(1 1) TRACK DIR(1) //HOLDMAST DD UNIT=SYSDA,SPACE=(TRK,(1,1,1))
DCB parameters must not be supplied by the user. FOCUS will create the HOLDMAST file with the current DCB. Members of the HOLDMAST file are created without line numbers.
If you want to retain the HOLDMAST file, give it a name and a DISP parameter.
FOCUS does not automatically allocate the following files. You must allocate them and supply the appropriate DCBs:
LET SAVE [membername]
FOCUS will store your LET statements in membername as a FOCEXEC. The default member name is LETSAVE. If FOCEXEC is not allocated, FOCEXEC is automatically allocated to ‘userid.FOCEXEC.DATA’, and the LETSAVE member is saved there.
LOG type ON ddname
where:
Is the error type criteria. FOCUS stores the list in a file allocated to DDNAME. There is no default for the DDNAME. DCB attributes must be provided for this DDNAME to correspond with the records being written.
POST [TO ddname]
FOCUS will store the results in a file allocated to ddname. If you omit the TO ddname option, the DDNAME defaults to FOCPOST.
You can allocate these files to multiple volumes. See Multi-Volume Support for information.
|
Information Builders |