Input specification
The Input Dataset Specification screen allows you to specify the input data set, record layout, and change criteria information. You may specify a business rules data set for the aging function or any external file needed for field exits. This is the first screen Data Solutions displays when you select Date Aging, Euro Tools, Data Analyzer, Translator, Generation, Field Exits, Encryption, or Replace from the Primary Option Menu.
The following figure is an example of the Input Dataset Specification screen.
Input Dataset Specification screen
COMMAND ===>
Specify Input Dataset Information:
Dataset name ===> DASAMP.EMPLOYEE
Member name ===> (Blank or pattern for member list)
Disposition ===> OLD (OLD or SHR)
I/O exit name ===> (User written I/O program)
Specify Record Layout Information and XREF Information:
Record layout usage ===> S (S = Single; X = XREF)
Record layout dataset ===> DASAMP.LAYOUTS
Member name ===> EMPLOYEE (Blank or pattern for member list)
XREF dataset name ===>
Member name ===> (Blank or pattern for member list)
Specify Criteria Information:
Use existing criteria ===> Y (Y = Yes; N = No)
Criteria dataset name ===> DASAMP.CHGCRIT
Member name ===> (Blank or pattern for member list)
Specify Business Rules or Field Exits Dataset Information:
Dataset name ===>
Field descriptions
Specify Input Dataset Information:
Data set name
Specify the name of the input data set.
You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Dataset Names for a complete description.
Member name
Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.
Disposition
Specify OLD or SHR. A DISP of NEW is available only for the Data Generation function. For more information, see Generation-function.
I/O exit name (Optional)
If the I/O exit option has been installed, this input area is provided. For more information, see IO_EXIT_USAGE in the File-AID/Data Solutions product configuration or your system programmer. I/O exit install options (IO_EXIT_USAGE) are:
NO | I/O exit name field is not presented. |
YES | I/O exit name field is presented blank for entry of a site written I/O exit program name. |
exitname | I/O exit name field is presented prefilled with the name of a site-written I/O exit program. |
Specify record layout information:
Record layout usage
Specify one of the following values:
S | Single record layout. Specify for formatted change criteria when one record layout is needed for a file. |
X | XREF (record layout cross reference). Specify for formatted aging criteria when more than one record layout is needed for a single file. |
When a formatted criteria member is created, it is assigned a single or multiple record status type based on what is specified in the Record layout usage field. If you edit this member at a later time, you must specify the same value in the Record layout usage field as when it was created.
Record layout dataset
Specify the name of a data set that contains the Assembler, COBOL or PL/I record layout. This file is required for formatted aging criteria and must be specified whether the Record layout usage field is S (single) or X (XREF). For more information, see Record Layout Dataset.
You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Dataset Names for a complete description.
Specifying a concatenation list
To specify a concatenation list to be used in place of the Record Layout dataset, enter a plus sign followed by the member name (+membername) of the member containing the list. Enter this in the Record layout dataset field instead of the Record Layout dataset name. For example, if the member RLPROD contains the list to be used, enter +RLPROD instead of a Record Layout Dataset name. You specified the name of the concatenation list data set in Option 0.1, Data Solutions system parameters (see Concatenation List DSN). The concatenation list data set contains members known as concatenation lists. Each such list contains names of record layout datasets, each of which in turn contains record layout members.
The concatenation list is used in place of the single Record Layout dataset name. If the concatenated libraries contain duplicate member names, Data Solutions will always select the first occurrence of the member name.
Member name
Specify the name of an existing Assembler, COBOL or PL/I record layout member.
You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Data set name and Member name fields at the same time.
If the Record layout dataset field specifies a concatenation list (+membername), leave the Member Name field blank or enter a pattern to display the Layout Selection Member list in section Data-set-types.
XREF dataset name
Specify the name of a data set that contains the record layout cross reference (XREF) members to use with multiple record type data sets. See Record Layout XREF Dataset .
Member name
Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.
Specify criteria information:
Use existing criteria
Specify one of the following valid entries:
Y | Use existing criteria. Enter a data set name in the Criteria dataset field. When using saved criteria, verify that you have specified the same layout file as when the criteria was created so that the offsets correspond properly to the data. |
N | (Default) -- Do not use existing change criteria. |
Criteria dataset name
Specify the name of the data set containing existing change criteria.
You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Dataset Names for a complete description.
Member name
Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.
Specify business rules or field exit dataset information:
Data set name
Specify the name of the data set containing the business rules you want to use for the aging process or any external file for field exits. For more information, see Business Rules.