SNSCOPE
The SNSCOPE system initialization parameter specifies whether a userid can be signed on to CICS more than once, within the scope of a single CICS region, a single MVS image, and a sysplex.
- SNSCOPE={NONE|CICS|MVSIMAGE|SYSPLEX}
- The signon SCOPE is enforced with the MVS ENQ macro where there
is a limit on the number of outstanding MVS ENQs per address space.
If this limit is exceeded, the MVS ENQ is rejected and CICS is unable
to detect if the user is already signed on. When this happens, the
signon request is rejected with message DFHCE3587.
You can use the ISGADMIN macro to set or reset the MVS ENQ limit.
For more information, see the z/OS MVS Programming: Authorized
Assembler Services Reference.
- NONE
- Each user ID can be used to sign on for any number of sessions on any CICS region. This is the compatibility option, providing the same signon scope as in releases of CICS before CICS® Transaction Server for z/OS®, Version 5 Release 2.
- CICS
- Each user ID can be signed on once only in the same CICS region. A signon request is rejected if the userid is already signed on to the same CICS region. However, the user ID can be used to signon to another CICS region in the same, or another, MVS image.
- MVSIMAGE
- Each userid can be signed on once only, and to only one of the set of CICS regions in the same MVS image that also specify SNSCOPE=MVSIMAGE. A signon request is rejected if the user is already signed on to another CICS region in the same MVS image.
- SYSPLEX
- Each user ID can be signed on once only, and to only one of the set of CICS regions within an MVS sysplex that also specify SNSCOPE=SYSPLEX. A signon is rejected if the user is already signed on to another CICS region in the same MVS sysplex.
The signon scope (if specified) applies to all user IDs signing on by an explicit signon request (for example, by an EXEC CICS SIGNON command or the CESN transaction). SNSCOPE is restricted to users signing on at local terminals, or signing on after using the CRTE transaction to connect to another system.
Signon scope specified by SNSCOPE does not apply to:- Non-terminal users.
- The CICS default userid, specified by the DFLTUSER system initialization parameter.
- Preset user IDs, specified in the USERID option of the DEFINE TERMINAL command.
- User IDs for remote users, received in attach headers.
- User IDs for link security. For information about which userid is used for link security on a specific connection, see Security-related system initialization parameters.
- The user ID specified on the PLTPIUSR system initialization parameter.
- The CICS region user ID.
Restrictions You can specify the SNSCOPE parameter in the SIT, PARM, or SYSIN only.