$CACCI OPT=RECEIVE

Requests that CA CCI receive data. Data arrives attached to a NOTIFY event until either a CANCEL or TERM is issued, or the NCL procedure terminates. The data is sent to the process-dependent request queue and read by the &INTREAD verb.

&CALL PROC=$CACCI PARMS=(OPT=RECEIVE,
                         ID=cci_id,
                        [NAME=name,]
                        [SYSID=sysid])

Operands:

ID=cci_id

Specifies the identifier returned in $CACCIID from an earlier CCI INIT call.

NAME=name

Identifies the name of an eligible sender. If omitted, data from any sender is eligible for this request. The name is visible on the CA SYSVIEW Performance Management CCI Receivers panel in the SenderId column.

Limits: 1 to 20 mixed case characters, numbers, spaces, and special characters. Special characters require quotes.

SYSID=sysid

Specifies the system ID of the sender from which to receive data. The SYSID is visible on the CA SYSVIEW Performance Management CCI Receivers panel in the SSysId column.

Notes:

Use &INTREAD TYPE=REQ or TYPE=ANY to read the data. If a timeout occurs on &INTREAD, the RECEIVE is not canceled and a subsequent &INTREAD can still read the data.

Note: See the Notes in the description for &INTREAD for details of the mapped data object $INT.

The notify message for the RECEIVE is located in $INT.TEXT and the data is in $INT.USERMDO. The notify message format is as follows:

N00101 NOTIFY: CCI EVENT: RECEIVE RESOURCE: ID=cci_id
LCLNAME=local_name RSYSID=remote_sysid RMTNAME=remote_name
RC=return_code

If the return code is not zero, RECEIVE is terminated and must be reissued. The following fields are appended to the message:

ERR=error code
ERRX=extended error code
DESC=error description

Always check the message text before reading the data because the INTQUE OCS command can also be used to satisfy the &INTREAD.