Previous Topic: SCANSTR()Next Topic: SETADDR()


SCRASID()

This function specifies that all WTOs from a particular address space are 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 action overrides other specifications that indicate specific WTO message IDs.

Syntax

Form 1:

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

Form 2:

status = SCRASID(?,asid,action)

Parameters

result

Null string (or error text).

route

Specify:

ADD

Adds a routing.

DELETE

Deletes a routing.

asid

Address space ID (ASID) to be monitored.

action

Specify:

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:

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

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 */