Use CESN to sign on to CICS® by using a user ID and
a password or a similar authenticator.
The CESN transaction can be used as a 3270 transaction from a 3270 terminal or as a single-line
command from both 3270 and non-3270 devices. This section describes the 3270 transaction. For
information about the line command, see Sign on - non-3270 family terminal.
The CESN sign-on transaction displays a BMS map. The transaction is pseudo-conversational and
uses the EXEC CICS SIGNON command. For details of the parameters on the BMS map,
see SIGNON.Figure 1. CESN transaction: initial screen
Signon to CICS APPLID DBDCCICS
. . . . . . This is where the "good morning" message appears. . . . . . .
. . . . . . It can be up to four lines in depth to contain the. . . . .
. . . . . . maximum message length of 246 characters (that is, three. .
. . . . . . full lines and six characters on the fourth line) . . . . .
Type your userid and password, then press ENTER:
Userid . . . . ________ Groupid . . . ________
Password . . . ________
Language . . . ___
New Password . . . ________
DFHCE3520 Please type your userid.
F3=Exit
The panel for screens sized 40 x12 is shown below. There is no space on these screens for the
release number or the “good morning” message.Figure 2. CESN transaction: 40 x
12 screen
Signon to CICS APPLID DBDCCICS
Userid . . . . ________
Groupid . . . . ________
Password . . . . ________
Language . . . . ___
New Password . . ________
DFHCE3520 Please type your userid.
F3=Exit
Notes:
If a user signs on at a terminal that is already signed on, CESN signs off the previous user.
However, it does not happen unless the user completes the CESN panel before pressing ENTER.
For mixed case passwords to be supported, ensure that the PROFILE for the sign-on transaction
CESN specifies UCTRAN(NO). This is the value for the CICS-supplied definitions. Otherwise, passwords
that are specified in the CESN transaction are converted to uppercase.
If support for mixed case passwords is in use, CICS saves the value of the UCTRAN option for the
terminal and temporarily sets it to UCTRAN(NO) while the user is prompted to enter credentials. The
user ID and other parameters are always translated into uppercase but the password remains in the
case entered by the user. When the CESN transaction completes, the UCTRAN attribute is restored to
its original value. If the user disconnects from the terminal before the transaction is completed,
the terminal might be left with the UCTRAN(NO) attribute set.
If the old password expires, this dialog prompts for a new password. The password can also be
changed before it expires.
By default, when PF3 or PF15 is used, the CICS sign-on transaction terminates but the terminal
session remains connected. For better terminal security, you can use the DISCONNECT option of the
GMTRAN system initialization parameter. If you specify this option, PF3 or PF15 disconnects the
terminal session. For more information, see GMTRAN system initialization parameter,
Autoinstall of BMS maps is not carried out within the CESN transaction. When CESN tries to send
out any BMS map that is not installed, CESN sends out the English BMS map.
You can customize the CESN map set only if you do not change the format of the symbolic map set.
The source for the CESN map is included in map set DFHSNLE in the SDFHSAMP library. After
customization, regenerate the physical map sets in the usual way into a load library, which must be
included in your DFHRPL concatenation in front of the CICS
libraries. For more information, see Basic mapping support.
Unsuccessful sign-on and sign-off errors cause DFHCEnnnn messages to be issued.
RACF OIDCARD users can use CESN to sign on if the card reader supports the DFHOPID attention
identifier (AID). If it does not, you will need to write your own sign-on program using the EXEC
CICS SIGNON command. For programming information, see SIGNON.