CONNECT function (connect a user or group to a group)

Use the CONNECT function to connect a user or group to a group.

AUTHORITY
The user must have access to the zSecure CICS® Toolkit command (TOOLKIT.CONN) and the target group (CONN.dfltgrp)
COMMAREA
Minimum size 112 bytes. If your application requires access to the REVOKE and RESUME dates, the minimum length is 122 bytes.

In your application, use the CQTMAPIA or CQTMAPIC mapping macros (copybooks) provided in the SCQTMAC library.

API_FUNC         DC  CL4'CONN'  Function code for CONNECT
API_RC           DC  XL01'00'   Return code
API_MSG          DC  CL79' '    Message area
API_CONN_RC      DC  XL1        Return code from CONNECT. If
*                               non-zero the command failed.
*                               API_MSG will give the reason for
*                               the failure.
*
API_CONN_USERID  DC  CL8        Userid/group being connected.
*
API_CONN_GROUP   DC  CL8        Group being connected to.
*
API_CONN_AUTH    DC  CL1        Connect authority
*                               Must be 'U' (use),
*                               'C' (create)
*                               'N' (connect) or
*                               'J' (join).
*
API_CONN_OWNER   DC  CL8        Owner of the connect profile. It
*                               must be a valid userid or group.
*
API_CONN_SPEC    DC  CL1        Specify 'Y' if the user should have the
*                               group-special attribute otherwise
                                specify 'N'.
*
API_CONN_OPER    DC  CL1        Specify 'Y' if the user should have the
*                               group-operations attribute otherwise
*                               specify 'N:'.
*
API_CONN_REVOKE  DC  CL5        The date (YYDDD) the user is to be REVOKED
*
API_CONN_RESUME  DC  CL5        The date (YYDDD) the user is to be RESUMED

The API_CONN_REVOKE and API_CONN_RESUME fields can be used to set or remove the REVOKE and RESUME dates for the connection. If you use the value blanks (x'4040404040'), the revoke and resume dates are left at their current value. If you use the special date zeros (c'00000' = x'F0F0F0F0F0'), the current Revoke/Resume date is removed. Using this last special value, you can implement a function like the NOREVOKE and NORESUME keywords of the z/OS® 1.7 RACF® CONNECT command. If you specify today's date for either the REVOKEDT or the RESUMEDT, the revoke-status for the user is updated immediately and the other date value is ignored. Both the RESUMEDT and the REVOKEDT are reset.