IBM Connect:Direct API
The IBM® Connect:Direct® API (DGASVPSA) communicates with the Data Transmission Facility through an application interface. DGASVPSA signs on to the local DTF, submits a Process, and signs off of the local DTF.
| Module or Command | Description |
|---|---|
| DGASVPSA | DGASVPSA is part of the VPS interface and is distributed
in $CD.SDGASAMP. This program is in source form. You can assemble
and link-edit when you install a new release of IBM Connect:Direct VPS. It uses the VPS system log for reporting exception conditions and informational messages describing the Processes submitted to the local DTF. This log serves as one central point to determine the status of any print file controlled by VPS. The DGASVPSA program receives control from VPSSCDI and validates the function calls and control block fields passed by VPSSCDI. If a function executes successfully, the program returns a condition code of 0 (zero) to the VPSSCDI. If a noncritical error occurs, DGASVPSA returns a code of 4 to VPSSCDI to indicate that VPS requeues the print file according to VPS printer specifications. If DGASVPSA detects a critical error, it returns a code of 8 or greater, indicating that VPS can EDRAIN the printer. A function call of PRINTER INITIALIZATION causes a SIGNON to be sent to the local DTF as defined in the network map specification for this printer. A function call of DATA SET SYSOUT READY invokes the routines to validate the control blocks and build the IBM Connect:Direct SUBMIT PROCESS command and send it to the local DTF. A function call of PRINTER TERMINATION sends a SIGNOFF to the local DTF. DGASVPSA uses the IBM Connect:Direct API interface module (DGADCHLA) to communicate with the Data Transmission Facility. |
| VPSSCDI | The VPS module VPSSCDI, the interface to IBM Connect:Direct, is distributed in VPS. This program is in source form and you can reassemble and link-edit it when you install a new release of VPS or IBM Connect:Direct. |
| SIGNON | This command uses the network map specification
for the specified IBM Connect:Direct printer. If you do not have a network map override specified in the VPS printer definition table (CDNETMAP), the SIGNON command uses the DMNETMAP DD statement in the VPS startup JCL for the network map. |
| SIGNON Security | The SIGNON command for DGASVPSA does not pass
a user id or password. If you use the Stage 1 security exit, user
id associated with the VPS started task is extracted and the user
id and a special password (assigned by the Stage 1 exit) is placed
in the UICB, a user interface control block used for security. If the Stage 1 processing is successful, the SIGNON command passes to the DTF, where the DTF Stage 2 security is invoked. The Stage 2 exit recognizes the special password, as assigned by the Stage 1 exit. All verification calls to the security system are by user id only. If you send to a secured IBM Connect:Direct, you can specify user id and password by adding the SNODEID specification to the Process. All Processes submitted by the VPS API have the security access level associated with the VPS job or started task, unless the security is overridden by PNODEID, SNODEID, and/or secure point-of-entry (SPOE) translation. |