Syntax for an Output Set

A single execution of the output management program can produce multiple sets of output, and each output set can produce one to three reports.

A single execution of output management can produce only one output set for a single host, but multiple hosts can be processed in each run.

Related topic

HSM-collector

The syntax for an output set consists of the following parameters:

  • One action parameter (BACKUP, MIGRATION, DFDSS, and so on) that specifies input from DFSMShsm or DFDSS
  • One or more action parameters (ERROR, REPORT, ACTION) that specifies output to reports or card image generation
  • For each output action parameter, one or more selection parameters (INCLUDE, EXCLUDE, and so on) and one or more keywords (ID, RC, REASON, and so on)
  • For each card image generation action parameter (SAVE, START), one action parameter specifying a skeleton member

Some parameters require a keyword followed by a value, while other parameters require a value or stand alone, as shown in the following examples:

Example

REPORT: no value follows the REPORT parameter

INCLUDE ID=ARC0523I: no value follows the INCLUDE parameter, but the ID keyword must be followed by a value

Observe the following additional conventions when using parameters:

  • Parameters can begin in any column.
  • A single parameter must be contained on one line.
  • Multiple parameters can be on the same line, or separate lines, except for INCLUDE/EXCLUDE specifications, which must be contained on one line.
  • There is no line continuation character.
  • The maximum line length is 80.
  • Blank lines are ignored.
  • Comment lines must start with an asterisk in column 1. There is no facility for embedded comments (all comments must be on a separate line).
  • Like BMC AMI Storage function filter statements, selection parameters on the same line are joined with the AND operator; selection parameters on separate lines are joined with the OR operator.
  • Selection keywords cannot be duplicated after a single INCLUDE/EXCLUDE parameter. For example, the statement INCLUDE AGE>30 AGE<60 is invalid; only the last AGE keyword is used.

You can use the following features with message selection keywords. (Message selection keywords are always specified after an INCLUDE or EXCLUDE parameter).

  • You can use name masking in the ID message selection parameter. The following name masking characters are available:

    % represents any single numeric character.

    ? represents any single alphanumeric character, except the period character (.).

    / represents any character string, any length.

  • You can use the following comparison operators in the RC, REASON, and AGE message selection parameters:

    = (equals): parameter must equal the specified value

    / (not equals): parameter must not equal the specified value

    < (less than): parameter must be less than the specified value

    > (greater than): parameter must be greater than the specified value

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*