GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-35
GET^ITC^FCB
fcb-address output
INT(32):ref
is the FCB address of the receiving task.
dcb-address output
INT(32):ref
is the address of a DCB. This parameter is used when you require information about
the physical attributes of a device; physical attributes are stored in the DCB.
Considerations
When an SU is configured by SCF, the SU name consists of two or three names in one
of these formats:
$GDSX-process-name.#su-name
$GDSX-process-name.#su-name.qualifier
To specify the SU name of the receiving task for GET^ITC^FCB to search for, you must
allocate a buffer and initialize it to $GDSX-process-name, #su-name, and the
qualifier, if it has one. The buffer parameter of GET^ITC^FCB is a pointer to
that buffer. When GET^ITC^FCB finds a match between the SU name specified in
buffer and an SU name in dcb.name of the dcb^template, it returns the FCB and DCB
addresses.
Example
In this example a task will send ITC messages to TERM1, which was configured with an
SU name of $GDSX.#SU00l.TERM0001. The task calls GET^ITC^FCB to obtain the
FCB address of TERM1. After it has the FCB address, the task can use
SEND^ITC^MSG[X] as many times as necessary to send messages to TERM1. The
example shows one instance of sending a message with SEND^ITC^MSGX:
@buffer^pointer := GETEXTPOOL(10, 8);
buffer^pointer ':=' ["$GDSX.#SU001.TERM0001"];
error := GET^ITC^FCB (buffer^pointer:21, fcbaddr, dcbaddr);
.
.
.
IF NOT error THEN
BEGIN
@itc^fcb^struct^pointer := fcbaddr;
CALL SEND^ITC^MSGX (itc^fcb^struct^pointer,
buffer^with^data,
length^sent,
length^returned,
tag,
writeread^operation);
.
.