The //SELECT-INPUT-FILES statement is used to select the files that are to be selected. This statement may be specified only once per SATUT run.
SELECT-INPUT-FILES | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
INPUT-FILES =
This defines the type of file to be used as input for preparation.
INPUT-FILES = *STD(...)
This means that only files with standard names (SATLOG files, replacement files and/or CONSLOG files) will be specified as input files for SATUT.
TYPE = list-poss(3): *SAT / *CONSLOG
This defines the type of file to be selected for editing.
TYPE = *SAT
Input files may be SATLOG files or replacement files only.
TYPE = *CONSLOG
CONSLOG files are used as input files.
STATUS =
This specifies the status of the input file.
STATUS = *CLOSED
The specified file must be closed.
STATUS = *NOT-CLOSED
The specified file must not be closed.
STATUS = *ALL
Any status is permissible for the specified file.
PUBSET =
This specifies the pubset on which SATUT is to look for the specified files.
For reasons of compatibility, the specification PUBLIC-VOLUME-SET or PUB-VOL-SET is still permitted in place of PUBSET.
PUBSET = *STD
SATUT is to look for the specified files on the default pubset of the SYSAUDIT user ID.
PUBSET = list-poss(20): <cat-id 1..4>
SATUT is to look for the specified files on the specified pubsets.
DATE =
This specifies the date that the input files are to have.
DATE = *ALL
Any date is permissible in the standard name of the input file.
DATE = <date 8..10>
Creation date as specified in the standard name of a SATLOG file or a CONSLOG file. In the case of a replacement file, the creation date is identical with that of the first SAT logging file with standard name used for its creation.
DATE = *INTERVAL(...)
The creation date in the standard input file name must be within the specified interval. The value specified for the year must lie between 1960 and 2059 and may be specified as two or four digits. A year number specified with two digits which is less than 60 is regarded as being in this century, while two-digit year numbers greater than or equal to 60 are regarded as being in the previous century. These limits must also be observed even if the year number is specified with four digits; “1955”, for example, is an invalid specification.
FIRST-DATE = <date 8..10>
Lower limit of the interval within which the creation date in the standard input file name is to lie.
LAST-DATE = <date 8..10>
Upper limit of the range within which the session number in the standard input file name is to lie.
SESSION-NUMBER =
This specifies the session number of the input files.
SESSION-NUMBER = *ALL
Any session number is permissible in the standard name of the input file.
SESSION-NUMBER = <integer 1..999>
The session number as specified in the standard name of the file. In the case of a replacement file, the session number is identical with that of the first input file with a standard name used for its creation.
SESSION-NUMBER = *RANGE(...)
The session number as specified in the standard name of the input files must be within the specified range.
FIRST-SESSION-NUMBER = <integer 1..999>
Lower limit of the range within which the session number in the standard input file name is to lie.
LAST-SESSION-NUMBER = <integer 1..999>
Upper limit of the range within which the session number in the standard input file name is to lie.
SEQUENCE-NUMBER =
This specifies the sequence number of the input files.
SEQUENCE-NUMBER = *ALL
Any sequence number is permissible in the standard name of the input file.
SEQUENCE-NUMBER = <integer 1..999>
Sequence number as specified in the standard name of the file. In the case of a replacement file, the sequence number is identical with that of the first input file with a standard name used for its creation.
SEQUENCE-NUMBER = *RANGE(...)
The sequence number as specified in the standard name of the input files must lie within the specified range.
FIRST-SEQU-NUMBER = <integer 1..999>
Lower limit of the range within which the sequence number in the standard input file name is to lie.
LAST-SEQU-NUMBER = <integer 1..999>
Upper limit of the range within which the sequence number in the standard input file name is to lie.
INPUT-FILES = list-poss(100): <filename 1..54>
File name of the analysis file to be used as the input file for SATUT.
Here you can only specify analysis files. These are files that were generated using the statement below in an earlier SATUT run:
//SAVE-SELECTED-RECORDS ..., TO-REDUCTION-NAME=<filename 1..54>
SATLOG files, replacement-files and CONSLOG files files must be declared as input files using INPUT-FILE=*STD(...).
For example, for the assignment of the file SYS.SATLOG.2017-04-24.006.02, the following INPUT-FILES specification is necessary:
INPUT-FILES=*STD(DATE=2017-04-24,SESSION-NUMBER=6,SEQUENCE-NUMBER=2)
Notes
SATUT takes the following actions to prevent possible overlappings when using SATLOG files and/or replacement files and/or CONSLOG files as input files:
A list of audit file names is compiled from the input file names as follows:
If the input file is a SATLOG file or a CONSLOG file, its name is copied.
If the input file is a replacement file, the names of the SATLOG files / CONSLOG files from which it was derived are copied.
The statement is rejected if the name of a SATLOG file / CONSLOG file appears more than once in the list compiled as described under 1.
Example
A user with the privilege SAT-FILE-MANAGEMENT or SAT-FILE-EVALUATION wishes to edit the SATLOG file of session 003 for the period 02-05-2017 to 09-05-2017:
//select-input-files input-files=*std(type=*sat, pubset=*std, -// date=*interval(first-date=2017-05-02, last-date=2017-05-09), -// session-number=003, sequence-number=*all)
or its abbreviated form:
//sel-inp-files *std(date=int(2004-05-02,2004-05-09),sess-num=003)
This statement causes SATUT to search for SAT/SATUT files (SATLOG files or replacement files) under SYSAUDIT with a creation date within the period from 02-05-2017 to 09-05-2017 and with the session number 003.