Authorizing access to a CICS region z/OS Communications Server ACB

You can control which users, among those who are running non-APF-authorized programs, can open the SNA ACB associated with a CICS® address space (CICS region).

Control ensures that only authorized CICS regions can present themselves as z/OS® Communications Server applications that provide services with this applid, thus preventing unauthorized users from impersonating real CICS regions. The CICS region user ID requires the OPEN access, not the issuer of the z/OS Communications Server SET VTAM® OPEN command.

  1. To enable CICS to start with external security, authorize the CICS region user ID to open the CICS region's z/OS Communications Server ACB with the applid specified on the APPLID system initialization parameter.
  2. For each applid, create an z/OS Communications Server APPL profile, and give the CICS region user ID READ access. For example:
      RDEFINE VTAMAPPL applid UACC(NONE)  NOTIFY(userid)
      PERMIT applid CLASS(VTAMAPPL) ID(cics_region_userid) ACCESS(READ)
    The correct CICS applid to specify in the VTAMAPPL class is the specific applid, as specified in the CICS system initialization parameters. If you are using XRF (that is, if CICS is started with XRF=YES), you must define two VTAMAPPL profiles — one each for both the active and alternate CICS region's specific applid (the second operand on the CICS APPLID startup option).
  3. Ensure that the VTAMAPPL class is active and RACLISTed for this protection to be in effect; for example:
        SETROPTS CLASSACT(VTAMAPPL) RACLIST(VTAMAPPL)
  4. If a CICS region will not use z/OS Communications Server, do not reauthorize the CICS region user ID for the CICS applid.
  5. If you do not control the opening of a CICS region's z/OS Communications Server ACB, a new z/OS Communications Server application started with the same applid as that of a running CICS region has the following effect:
    • The running CICS region performs a FORCECLOSE of its SNA ACB and issues message DFHZC0101.
    • The running CICS region either ends or continues, depending on your use of the XXRSTAT exit. The default is to end. If the CICS region continues, it no longer uses z/OS Communications Server.
    • The new application opens the z/OS Communications Server ACB with the specified applid.
    • If the first running CICS region used z/OS Communications Server persistent sessions, the new application recovers any z/OS Communications Server sessions that persist from that CICS region.

For information about creating z/OS Communications Server APPL profiles for CICS region applids, see the CICS system resource security. For information about the XXRSTAT exit, see the Exit XXRSTAT.



dfha13f.html | Timestamp icon Last updated: Sunday, 4 June 2017