Previous Topic: SCANSTR()

Next Topic: SETADDR()

SCRASID()

Use SCRASID() to specify that all WTOs from a particular address space be recorded on an ILOG file. You can also specify an IMOD to be executed for each WTO message.

Important! Use care when intercepting all WTOs from an address space, as this overrides other specifications that indicate specific WTO message IDs.

Syntax

The SCRASID() function has this syntax:

Form 1:

result = SCRASID(route,asid,action,num)

Form 2:

status = SCRASID(?,asid,action)

Arguments

The SCRASID() function takes these arguments:

result

Null string (or error text).

route

Specify one of the following:

ADD Adds a routing.

DELETE Deletes a routing.

asid

Address space ID (ASID) to be monitored.

action

Specify one of the following:

IMOD Triggers an IMOD.

ILOG Writes the message to an ILOG.

num

Number, from 0 through 14, that you assign. This number is used to construct the ILOG or IMOD name, as follows:

  • If ILOG was specified, the ILOG number is the value of the num argument.
  • If IMOD was specified, the IMOD name is ASID_num.

status

Value of num, as set by a previous use of the SCRASID() function.

?

Returns the current status of the ILOG or IMOD specification for the address space. A null return indicates that the address space is not being monitored.

Return Codes

The SCRASID() function produces these return codes:

101 - 104 ARG n MISSING OR INVALID

120 NO SUBCOM AREA

121 DOES NOT FUNCTION IN BATCH MODE

Example

scrasid('add','195','ilog',12)    /* Start logging */
scrasid('?','195','ilog') == 12   /* ILOG used for this ASID */