Store specifications for DCAM application in CLT
Component: | DCAM |
Functional area: | Data communication control |
Domain: | NETWORK-MANAGEMENT |
Privileges: | STD-PROCESSING |
Function
The SET-DCAM-APPLICATION-LINK command can be employed by DCAM users to store specifications for a DCAM application in a job-specific table, the CLT (communication link table).
When the DCAM application is opened by a DCAM user program, the values in the table replace the corresponding entries in the application control block ACB (Assembler) or in the application structure (COBOL). The link between the CLT entry and this program area is established by means of the link name, which must be specified for this purpose both in the command and in the program (see also the “DCAM Program Interfaces” [7] and “DCAM Macros” [6] manuals on the subject of the name assignment function).
Specifications omitted from the command are taken from the program (default value: *BY-PROGRAM in the relevant command operands).
Format
SET-DCAM-APPLICATION-LINK | |||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||
Operands
LINK-NAME = <name 1..8>
Link name defined in the ACB of the program that is to open a DCAM application or that wishes to connect with an existing DCAM application.
APPLICATION-NAME = *BY-PROGRAM / <name 1..8>
Name of the DCAM application.
DISTRIBUTION-NAME = *BY-PROGRAM / <name 1..8>
Distribution name under which a program may receive messages from the DCAM application.
PROTECTION = *PARAMETERS(...)
Protection attributes for the DCAM application.
CONNECTION-PASSWORD = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8> / *SECRET
Defines the connection password as declared by the primary task and to be specified at each request for connection to this DCAM application.
The operand CONNECTION-PASSWORD is defined as “secret”:
The value which is input will not be logged.
In guided dialog, the input field is automatically blanked out.
In unguided dialog and in foreground procedures, *SECRET or ^ allows for concealed input of the required value. SDF requests the input of the “secret” value and provides a blanked input field for this purpose.
SHARE-PASSWORD = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8> / *SECRET
Defines the application password as defined by the primary task and to be specified by every secondary task when connecting to this DCAM application. The operand SHARE-PASSWORD is defined as “secret”:
The value which is input will not be logged.
In guided dialog, the input field is automatically blanked out.
In unguided dialog and in foreground procedures, *SECRET or ^ allows for concealed input of the required value. SDF requests the input of the “secret” value and provides a blanked input field for this purpose.
SHARE-PASSWORD = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8> / *SECRET
Specifies the application password for connection to a DCAM application, in the way the password was defined in the primary task or was stored in the RDF file.
The operand SHARE-PASSWORD is defined as “secret”:
The value which is input will not be logged.
In guided dialog, the input field is automatically blanked out.
In unguided dialog and in foreground procedures, *SECRET or ^ allows for concealed input of the required value. SDF requests the input of the “secret” value and provides a blanked input field for this purpose.
HOST-NAME = *BY-PROGRAM / <name 1..8>
Specifies the name of the real or virtual host on which the DCAM application is to be opened.
Return codes
The command provides no command-specific command return codes (see section "Return codes").