Add virtual DCAM connection to CLT
Component: | DCAM |
Functional area: | Data communication control |
Domain: | NETWORK-MANAGEMENT |
Privileges: | STD-PROCESSING |
Function
The SET-DCAM-CONNECTION-LINK command is used by DCAM users in order to store specifications for a logical DCAM connection in a job-specific table, the CLT (communication link table). When such a connection is being established, the values in the table supplement or replace the corresponding entries in the connection control block CCB (Assembler) or in the connection structure (COBOL). The linkage of the CLT entry with this program area is formed by 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 not given in the command are taken from the program (default value: *BY-PROGRAM in the relevant command operands).
Format
SET-DCAM-CONNECTION-LINK | ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
Operands
LINK-NAME = <name 1..8>
Link name defined in the CCB of the program that is to establish the logical connection. This link name forms the link between the entry in a job-specific table (CLT) and an area in the program (CCB or connection structure).
PARTNER-ADDRESS = *PARAMETERS(...)
Specifications regarding the partner to whom a connection is to be established.
PARTNER-NAME = *BY-PROGRAM / <name 1..8>
Name of the partner.
PROCESSOR-NAME = *BY-PROGRAM / <name 1..8>
Name of the processor where the partner is located as a station.
CONNECTION-PASSWORD = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8> / *SECRET
Specifies the connection password as defined by the partner to whom the DCAM connection is to be established.
The CONNECTION-PASSWORD operand is defined as “secret”:
The input value is not logged.
The input field is automatically blanked in a guided dialog.
The specification *SECRET is only permissible in an unguided dialog. This makes it possible to conceal the entry of the desired value. SDF prompts the user to enter the “secret” value and presents a blanked input field after the message.
USER-DATA = *BY-PROGRAM / <c-string 1..4> / <x-string 1..8>
Character string to be passed to the program via the connection as secondary information on a message.
With DCAM-COBOL, this operand is not evaluated.
Return codes
The command provides no command-specific command return codes (see section "Return codes").