The autoinstall control program at DELETE

The autoinstall control program is reinvoked when an autoinstalled resource is deleted. (The resources that can be autoinstalled are listed under The autoinstall control program at INSTALL.) Invoking the user program at DELETE enables you to reverse the processes carried out at INSTALL.

The parameter list passed to your user program at DELETE of local terminals is described in topic The autoinstall control program at DELETE. The parameter list passed at DELETE of local APPC connections is described in topic The autoinstall control program at DELETE. The parameter list passed at DELETE of shipped definitions is described in topic The autoinstall control program at DELETE. This section describes DELETE of Client virtual terminals at The communications area at DELETE for Client virtual terminals and bridge facility virtual terminals at The communications area at DELETE for bridge facility virtual terminals.

Shipped terminal and connection definitions are deleted by the CICS® Transaction Server for z/OS®, Version 3 Release 1 timeout delete mechanism. For details of the timeout delete mechanism, see the CICS Intercommunication Guide.

The communications area at DELETE for Client virtual terminals

The communications area passed to the autoinstall user program at DELETE.

Figure 43. Autoinstall control program’s communications area at DELETE. For Client virtual terminals.
DELETE_SHIPPED_COMMAREA         DSECT ,        Delete parameter list
DELETE_SHIPPED_STANDARD         DS  F          Standard field
DELETE_SHIPPED_EXIT_FUNCTION    DS  XL1        Delete  type
DELETE_SHIPPED_TERM             EQU X'FC'      Delete virtual terminal
DELETE_SHIPPED_EXIT_COMPONENT   DS  CL2        Component ID 'ZC'
                                DS  CL1        Reserved
DELETE_SHIPPED_TERMID           DS  CL4        TERMID
DELETE_SHIPPED_APPLID           DS  CL8        Applid of Client workstation
DELETE_SHIPPED_LTERMID          DS  CL4        TERMID in this region
DELETE_SHIPPED_NETNAME          DS  CL8        Netname of Client workstation

At DELETE, all fields in the communications area are input only. Fields not listed below are as described for INSTALL.

DELETE_SHIPPED_EXIT_FUNCTION
A 1-byte field that indicates the type of resource being deleted. The equated value for Client virtual terminals is DELETE_SHIPPED_TERM (X'FC').
Note:
A value of X'F1' represents the deletion of a local terminal, or an APPC single-session device that was autoinstalled via a CINIT request--see topic The autoinstall control program at DELETE. A value of X'F5' or X'F6' represents the deletion of an APPC connection that was installed by a BIND request--see topic The autoinstall control program at DELETE. A value of X'FA' or X'FB' represents the deletion of a shipped terminal or connection--see topic Figure 40.
DELETE_SHIPPED_TERMID
A 4-character field containing the name by which the virtual terminal is known to the Client.
DELETE_SHIPPED_APPLID
An 8-character field containing the netname (applid) of the Client workstation.
DELETE_SHIPPED_LTERMID
A 4-character field containing the name by which the virtual terminal is known in this region. This may or may not be the same as the value in DELETE_SHIPPED_TERMID, depending on whether an alias was used at install.
DELETE_SHIPPED_NETNAME
An 8-character field containing the netname of the Client workstation. This field contains the same value as DELETE_SHIPPED_APPLID.

The communications area at DELETE for bridge facility virtual terminals

The communications area passed to the autoinstall user program at DELETE.

Figure 44. Autoinstall control program’s communications area at DELETE. For bridge facility virtual terminals.
*                                                                       
*---------------------------------------------------------------------* 
* Delete  Bridge Facility                        - Function 16        *  
*---------------------------------------------------------------------* 
DELETE_BRFAC_COMMAREA       DSECT ,   Delete parameter list        
DELETE_BRFAC_STANDARD       DS  F     Standard field               
                            ORG DELETE_BRFAC_STANDARD         
DELETE_BRFAC_EXIT_FUNCTION  DS  XL1   Delete  type                 
DELETE_LINK_BRFAC             EQU X'10' Delete Link Brfacility    
DELETE_START_BRFAC            EQU X'12' Delete Start Brfacility   
DELETE_BRFAC_EXIT_COMPONENT DS  CL2   Component ID 'BR'            
                            DS  CL1   Reserved                     
DELETE_BRFAC_TERMID         DS  CL4   Termid                       
                            DS  CL8   Reserved                     
                            DS  CL4   Reserved                     
DELETE_BRFAC_NETNAME   DS  CL8   Netname of terminal          

At DELETE, all fields in the communications area are input only. Fields not listed below are as described for INSTALL.

DELETE_BRFAC_EXIT_FUNCTION
A 1-byte field that indicates the type of resource being deleted. For deletion of bridge facility virtual terminals. The equated values are:
INSTALL_LINK_BRFAC (X'10')
The autoinstall program was called during installation of a bridge facility to be used by the Link3270 bridge.
INSTALL_START_BRFAC (X'12')
The autoinstall program was called during installation of a bridge facility to be used by the START bridge.
DELETE_BRFAC_EXIT COMPONENT
A 2-byte component code, which is set to ‘BR’
DELETE_BRFAC_TERMID
A 4-character field containing the bridge facility name.
DELETE_BRFAC_NETNAME
An 8-character field containing the netname of the bridge facility.

Related concepts
How Client virtual terminals are autoinstalled
How bridge facility virtual terminals are autoinstalled
Related tasks
Rewriting user-replaceable programs
Assembling and link-editing user-replaceable programs
Related reference
The autoinstall control program at INSTALL
Default actions of the sample programs
[[ Contents Previous Page | Next Page Index ]]