Previous Topic: Pipe Stage Commands

Next Topic: Hypothetical Case Study—Migrating from Tivoli NetView

Edit Stage Orders

The following edit stage orders are supported:

COPY

Copies one or more unread lines in a multiline message from input to output.

Type: Global

COPYREST

Copies all unread lines in a multiline message from input to output.

Type: Global

FINDLINE n

Changes the current line to the absolute line number indicated by the argument.

Type: Global

FINDLINE string

Advances the current line to the line containing the specified target string.

Type: Global

FWDLINE n

Moves the current line forward by the number specified.

Type: Global

LASTLINE

Resets the input to the last line of a multiline message.

Type: Global

NEXTLINE

Combination of WRITELINE and READLINE. WRITELINE takes what is currently in the text buffer and writes it to the output message as a line.

Type: Global

PAD

Defines the padding character to be used by all other orders.

Type: Global

PARSE

Defines how the WORD input order will count words.

Type: Global

READLINE

Provides the next line of a multiline message to the input orders.

Type: Global

RESET

Cancels all existing SKIPTO and UPTO orders.

Type: Global

SKIPTO

Redefines the logical start of the input line.

Type: Global

TOPLINE

Resets the input to the first line of a multiline message.

Type: Global

UPTO

Redefines the logical end of the input line.

Type: Global

WRITELINE

Writes all text built by the output orders to the output message.

Type: Global

CURRGMT

Specifies an 8-byte store clock value generated at the time the order is executed.

Type: Input

hexstring

Specifies a hexadecimal string.

Type: Input

lineattr

Specifies that the input is one of the line attributes of the current line.

Type: Input

LINESENDER

Specifies the name of the sender.

Type: Input

msgattr

Specifies that the input is one of the message attributes of the current message.

Supported attributes are IFRAUSDR, MSGCOUNT, and MSGORIGIN.

Type: Input

position.length

Specifies the subset of the input line to be processed. The subset is defined by specifying a starting character and the total number of characters.

Type: Input

/string/

Specifies a delimited character string.

Type: Input

WORD

Specifies the subset of the input line to be processed. The subset is defined by specifying a starting word and the total number of words.

Type: Input

B2C

Converts string of Boolean values to a character string.

Type: Conversion

C2B

Converts input to a string of Boolean values.

Type: Conversion

C2D

Converts input to a string representing a decimal number.

Type: Conversion

C2F

Converts input to a string representing a signed floating point number.

Type: Conversion

C2V

Converts a varying length string to a character string.

Type: Conversion

C2X

Converts input to a string representing its hexadecimal notation.

Type: Conversion

D2C

Converts a signed integer number into a full word.

Type: Conversion

DT

Assumes the input text is a store clock (STCK) and converts the value to a readable 17-character string for the local time zone in the format MM/DD/YY HH:MM:SS.

Type: Conversion

FOUND

Translates a null string into No and any other string into Yes.

Type: Conversion

F2C

Converts a signed floating point number into a double-word.

Type: Conversion

LEFT

Truncates or pads the input to the length specified. Characters are counted from the beginning, or left, of the input.

Type: Conversion

ODDBYTES

Alternately, keeps and discards the input data.

Type: Conversion

OPDT

Assumes the input text is a store clock (STCK) and converts the value to a readable 17-character string representing the date and time in the format MM/DD/YY HH:MM:SS.

Type: Conversion

RIGHT

Truncates or pads the input to the length specified. Characters are counted from the end, or right, of the input.

Type: Conversion

STRIP

Removes all padding characters from the beginning and end of the input.

Type: Conversion

STRIPL

Removes all padding characters from the beginning of the input.

Type: Conversion

STRIPR

Removes all padding characters from the end of the input.

Type: Conversion

SUBSTR

Selects a subset of the input data.

Type: Conversion

UPCASE

Translates the standard 26-character Latin letters to uppercase.

Type: Conversion

V2C

Converts input to a varying length string.

Type: Conversion

X2C

Converts character data to internal hexadecimal format.

Type: Conversion

YESNO

Converts a 1-byte field to the character string Yes or No.

Type: Conversion

ZDT

Assumes the input text is a store clock (STCK) and converts the value to a readable - character string for Greenwich mean time in the format MM/DD/YY HH:MM:SS.

Type: Conversion

COLOR

Sets presentation attributes for the output line.

Type: Output

LINETYPE

Defines the line type attribute of the output line.

Type: Output

NEXT

Specifies that the input is to be placed into the output without an intervening blank.

Type: Output

NEXTWORD

Specifies that the input is to be placed into the output with an intervening blank.

Type: Output

position

Specifies that the data is to be placed in the output line beginning at the character, indicated by position.

Type: Output