Previous Topic: $CACCI OPT=INIT

Next Topic: $CACCI OPT=RECEIVE


$CACCI OPT=INQUIRE

Requests that CA CCI provide a list of eligible receivers in an MDO mapped by $NMMPCCI.

&CALL PROC=$CACCI PARMS=(OPT=INQUIRE,
                         ID=cci_id,
                         NAME=name,
                         [SYSID=sysid,]
                         MDO=mdoname,
                         SHARE=(mdoname>))

Operands:

ID=cci_id

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

NAME=name

Specifies a mask that only returns receivers with names that match this value.

Limits: 1 to 20 mixed case characters, including numbers, spaces, special characters, and asterisks to allow for pattern matching. Special characters require quotes.

SYSID=sysid

Specifies the ID of the system from which to retrieve the receiver. The ID can be a mask that only returns receivers with IDs that match this value. If omitted, only receiver IDs on the local system are selected.

Limits: 1 to 8 characters, including asterisks to allow for pattern matching (see $CACCI Example)

MDO=mdoname

Specifies the name of the MDO to return the results, and is mapped by $NMMPCCI.

SHARE=(mdoname>)

Specifies MDO to be shared with the called procedure. The data in the MDO mdoname can be seen by the calling procedure.

Notes:

The map for the returned MDO is as follows:

--<LK0(2,1) TAGS(EXPLICIT)>--
$NMMPCCI DEFINITIONS ::= BEGIN
Inquire ::= SEQUENCE
{
  numReceivers    <<1>>  INTEGER,
  cciReceivers    <<2>>  SEQUENCE OF <<3>> Receiver OPTIONAL
}
Receiver ::= SEQUENCE
{
  receiverID <<4>> ID,
  remote <<5>> BOOLEAN,
  active <<6>> BOOLEAN,
  messagesQueued <<7>> INTEGER
}
ID ::= SEQUENCE
{
  name <<8>> GraphicString (SIZE(1..20)),
  sysID <<9>> GraphicString (SIZE(1..8)) OPTIONAL
}
END