SEPARATE-FILES Separate SM2 output files

This statement can be used to split up a system-global SM2 output file created in the course of several monitoring cycles into its original components and distribute them to various output files. Even errored files can be split up.

The expression or operand *BLOCK used below defines a set of monitoring cycles in temporal succession. A block is understood to consist of at least one monitoring period and at most all monitoring periods.

Blocks are defined with the aid of indexes assigned to the monitoring time periods according to their position in the SM2 output file.

The interrelationship between index and monitoring period can be displayed using the statement SHOW-INFORMATION=*MONITORING-PERIODS.

The order in which the blocks are input is decisive in assigning them to the corresponding output files. Since, as a standard procedure, output files are opened and written in EXTEND mode, multiple blocks of the input file can be transferred to an output file in one pass. To do so, link names SM2UO1 to SM2UOn must be used for the same physical output file.

Format

SEPARATE-FILES

FILES = list-poss(99): *BLOCK(...)
	*BLOCK(...)
		|	FIRST-INDEX = <integer 1..32000>
		|	,LAST-INDEX = *SAME / *LAST / <integer 1..32000>

Operands

FILES = list-poss(99): *BLOCK(...)
The specified file blocks are separated. An output assignment must be effected for each file block using the /ADD-FILE-LINK command.

FIRST-INDEX = <integer 1..32000>
Specifies the index of the first monitoring period in a block to be separated. The index must be greater than the LAST-INDEX value of the preceding value.

LAST-INDEX =
Specifies the index of the last monitoring period in the block to be separated.

LAST-INDEX = *SAME
The last index is the same as the first one, i.e. precisely one monitoring cycle is separated for this block.

LAST-INDEX = *LAST
The file is separated up to the end of the input file.

LAST-INDEX = <integer 1..32000>
The index of the last monitoring period in the block to be separated is specified explicitly; the index must be greater than or equal to the associated FIRST-INDEX value.

Example

The first and second monitoring period of a merged SM2 output file (with at least three monitoring periods) with the link name SM2UI is to be assigned to a file with the link name SM2UO1, and the remaining monitoring periods are to be assigned to a file with the link name SM2UO2.

SEPARATE-FILES FILES = (*BLOCK(1,2), *BLOCK(3,*LAST))