SCRIPT_LINE_IGNORE_MASK - UCMD Manager configuration option

Owned by Stonebranch (Deactivated)
Jan 31, 2024

Description

The SCRIPT_LINE_IGNORE_MASK option, which is used in conjunction with the SCRIPT_FILE option, specifies a regular expression that is matched against each line of the script being sent to the remote system.

Any line that matches the mask will be ignored and not sent to the remote system as part of the script.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

n/a





Command Line, Long Form

-script_line_ignore_mask mask




(tick)

Environment Variable

n/a





Configuration File Keyword

script_line_ignore_mask mask




(tick)

STRUCM Parameter

n/a





Values

mask is a regular expression used to filter lines from a script specified with the -s option. Script lines that match the regular expression will not be transferred to the server for processing.

Example

An example use of the SCRIPT_LINE_IGNORE_MASK option would be to ignore script lines containing ITWS variables.

The following configuration line would cause any script run by Universal Command Manager to ignore script lines containing the text //*%OPC:
script_line_ignore_mask ".*//*%OPC"

If the intention were to ignore lines only where the ITWS variable started the line, the following regular expression could be used that "anchors" the expression to the start of the line:
script_line_ignore_mask "^//*%OPC"
 

Note

The '^' character is hex value 0x5F. Depending on the terminal code page settings, a different keyboard character may be required to get the 0x5F value into the regular expression string. It may be necessary to turn HEX ON in ISPF and manually adjust the hex value.

If the mask contains spaces or characters that are used by the command line interpreter, (for example, '-', '/'), the mask value must be enclosed in parenthesis.