GDSX (Extended General Device Support) Manual

Operations and Support
Extended General Device Support (GDSX) Manual—529931-001
3-5
Running SCF and Starting Requesters
The simplest GDSX configuration has no LINE and only dynamic SUs. Here are
commands for a configuration that does I/O by means of a device $TC1:
> RUN GDSE /NAME $GDSX, NOWAIT/
> RUN APPL /NAME $A1, OUT $GDSX.#TC1, NOWAIT/
The default for the configuration parameter MAXLINES (the maximum number of
LINE^HANDLER tasks) is 0, so this parameter value is not entered. (This is how the
GDSX example program is started in Section 4, DEVICE^HANDLER Example,
Running and Managing.)
This is the only type of configuration for which SCF is not needed to configure the
application. If SCF is used to manage the application, all currently configured SUs,
preconfigured and dynamic, are listed when the following command is issued:
-> INFO SU $GDSX-process-name.*.*
In the preceding example the device name $TC1 becomes #TC1 when combined with
the GDSX process name in the RUN command for the requester. When the
application process $A1 opens $GDSX.#TC1, GDSX receives the open message,
derives the device name $TC1 from the message, and opens file $TC1.
If the preceding example uses a device with name $TC1.#C11, the commands are:
> RUN GDSE /NAME $GDSX, NOWAIT/
> RUN APPL /NAME $A1, OUT $GDSX.#TC1.C11, NOWAIT/
Here the device name $TC1.#C11 becomes #TC1.C11 when combined with the GDSX
process name in the RUN command for the requester. When the application process
$A1 opens $GDSX.#TC1.C11, GDSX receives the open message, derives the device
name $TC1.#C11 from the message, and opens file $TC1.#C11.
If a GDSX application uses SCF to preconfigure an SU TC1 using a device named
$TC1, the following commands could be issued:
> RUN GDSE /NAME $GDSX, NOWAIT/
-> SCF
-> ADD SU $GDSX.#TC1
> RUN APPL /NAME $A1, OUT $GDSX.#TC1, NOWAIT/
Note how the device name $TC1 becomes #TC1 when combined with the GDSX
process name in the last two commands. When SCF is used to add the SU, the GDSX
process derives the proper device name from the ADD command, but does not open
the file until receiving an open message from requester $A1.
If the last example uses a device with name $TC1.#C11, the commands are:
> RUN GDSE /NAME $GDSX, NOWAIT/
-> SCF
-> ADD SU $GDSX.#TC1.C11
> RUN APPL /NAME $A1, OUT $GDSX.#TC1.C11, NOWAIT/
Now the device name $TC1.#C11 becomes #TC1.C11 when combined with the GDSX
process name in the last two commands.