ACT Specifying Complex-Level Ext. File Characteristics
You specify complex-level external file characteristics using Option 1, External File Specifications, on the External File Definition - File Options Menu (MWF;4;2;3;7;1). (See for instructions to specify characteristics for external journal files at the unit level.)
micsrm140cd
You specify complex-level external file characteristics using Option 1, External File Specifications, on the External File Definition - File Options Menu (MWF;4;2;3;7;1). (See ACT Specifying Journal File Characteristics for instructions to specify characteristics for external journal files at the unit level.)
The following subsections contain a worksheet and example to help you define complex-level external file characteristics.
Complex-Level Ext. File Specifications Worksheet
+----------------------------------------------------------------------------------------------------------+ | | | Date: ____/____/____ Administrator: ____________________________________________ | +----------------------------------------------------------------------------------------------------------+ COMPLEX-LEVEL EXTERNAL FILE SPECIFICATIONS WORKSHEET External File Name ________________ Description ____________________________________ Subsysid Variable ________________ Subtype Variable ________________ Effective Date Variable ________________ (ENDTS or SDTENTTS) Prorating ________ (YES or NO) If yes: Prorate from variable ________________ External File DD Statement - DDNAME must be INPUTACT //* Code the JCL DD statement to read your external file ____________________________________________________________________________________________________________ ____________________________________________________________________________________________________________ ____________________________________________________________________________________________________________ ____________________________________________________________________________________________________________ ____________________________________________________________________________________________________________ ____________________________________________________________________________________________________________
Use the Complex-Level External File Specifications Worksheet to define the following parameters:
- External File Name
- Description: The name of the external file.
- Default: None
- Values: Character, length 6, must begin with U or Z. The fourth character must be either U or Z; the combination of the last three characters must be unique.
- Description
- Description: A description of the external file; for information purposes only.
- Default: None
- Values: Character, length 40
- SUBSYSID Variable
- Description: The external file variable containing subsystem identification information.
- Default: Blank
- Values: Character, length 8
- Note:If this field is left blank, *ALL is the only SUBSYSID value that you may use on the Algorithm Qualification Worksheet for this file.
- SUBTYPE Variable
- Description: The external file variable containing type of work identification information.
- Default: Blank
- Values: Character, length 8
- Note:If this field is left blank, *ALL is the only SUBTYPE value that you may use on the Algorithm Qualification Worksheet for this file.
- Effective Date Variable
- Description: The external file variable that will be compared with the current date to determine the effective rates.
- Default: ENDTS
- Values: Character, length 8, ENDTS or SDTENTTS
- Prorating
- Description: Specifies whether the data for this external file is to be prorated. Prorating causes the charges for a single record to be distributed to one or more different cost centers.
- Default: NO
- Values: Character, length 3, Y, N, YES, or NO
- Note:If this field is YES, you must use prorating to specify how the charges are to be distributed (refer to Defining Prorating Charges).
- Prorate from Variable
- Description: The variable that controls whether prorating will be performed for a particular record.
- Default: COSTCTR1 if Prorating is YES; otherwise, blank
- Values: Character, length 8
- Note:If you do not want to prorate, leave this field blank.
- INPUTACT DD Statement
- Description: The JCL DD statement used to input the external file.
- Default: None
- Values: Character, length 72
- Note:The DDname must always be INPUTACT. This DD statement will be included in the generated ACTfffTB job for the file, where fff is the last three characters of the external file name.
Complex-Level External File Specifications Example
In the following External File Example, complex-level external file data consists of entries in a tape management system catalog. It does not contain SUBSYSID data. The effective date variable is SDTENTTS, and no prorating is desired. The file is cataloged to the SYS1.TMSCAT data set.
+-----------------------------------------------------------+ | Date: __/__/__ Administrator: _________ | +-----------------------------------------------------------+ External file ===> A description of the external file Subsysid Variable ===> Subtype Variable ===> Effective Date Variable ===> SDTENTTS (ENDTS or SDTENTTS) Prorating ===> NO (YES or NO) If yes: Prorate from variable ===> External File DD Statement - DDNAME must be INPUTACT //* Code the JCL DD statement to read your external file //INPUTACT DD DSN=SYS1.TMSCAT,DISP=SHR______________________