CA Dispatch passphrase support for VTAM logon.
search cancel

CA Dispatch passphrase support for VTAM logon.

book

Article ID: 190624

calendar_today

Updated On:

Products

Dispatch Output Mgmt

Issue/Introduction

Customers who utilize external security and access CA Dispatch 11.7 through a VTAM application ID (APPLID) can now specify a password phrase to logon to the CA Dispatch 11.7 online screens.

Environment

z/OS

Resolution

Customers who utilize external security and access CA Dispatch 11.7 through a VTAM application ID (APPLID) can now specify a password phrase to logon to the CA Dispatch 11.7 online screens. The new VTAM access password phrase support was introduced with APARS SO12180 and SO12181.

Password phrases can provide a stronger level of security when accessing the online screens of the product. A password phrase can be from 9 to 100 characters long and can include mixed-case letters, numbers, and special characters including blanks.

VTAM Password phrase support does not affect TSO, ISPF or CICS secure point logons. Accessing CA Dispatch from these secure access points does not require re-authenticating passwords.  The use of traditional eight character passwords during VTAM logon access continues to be fully supported and is unaffected by this enhancement.

If you access CA Dispatch directly via a VTAM APPLID, you can pass logon password phrase data via the DATA sub parameter. The total logon data passed to CA Dispatch is limited to a maximum of 44 bytes. If the logon data passed to CA Dispatch exceeds the 44 byte maximum limit, the user will be prompted to enter a password or password phrase (maximum of 100 bytes). 

        LOGON APPLID(DISPATCH) DATA('HI userid password phrase')

If you access CA Dispatch via CA TPX Session manager, you can pass logon password phrase data by using the &PWPH symbolic. The total logon session data passed to CA Dispatch is limited to a maximum of 44 bytes.  If the logon session data passed to CA Dispatch exceeds the 44 byte maximum limit, the user will be prompted to enter a password or password phrase (maximum of 100 bytes). 

        Session Data:    HI &USERID &PWPH

Users will have the ability to change/update their password or password phrase when the user is prompted to enter their current password or password phrase at logon. A new password must be from 1 to 8 characters in length and cannot include blank characters. A new password phrase can be from 9 to 100 characters long and can include mixed-case letters, numbers, and special characters including blanks. 

Password Change Example:

HI <USER1>
CADS - Enter External Security Password:  
OLDPW / NEWPW
CADS - Reenter New Password for Verification     
NEWPW
TSS7030I Password Changed                                                    
TSS7000I <USER1> Last-Used 24 Jan 20 07:47 System=XE91 Facility=DISPATCH     
TSS7001I Count=03186 Mode=Warn Locktime=None Name=<name>                       
IDMS DC258003 V1 USER <USER1> SIGNED ON LTERM VTMLT051 AT 07:52:28.62 20.024 
V1  Enter Next Task Code:                               

Password Phrase Change Example:

HI <USER1>
CADS - Enter External Security Password:  
<OLDPHRASE123> / <NEWPHRASE123>
CADS - Reenter New Passphrase for Verification     
<NEWPHRASE123>
TSS7135I Password Phrase Changed                                             
TSS7000I <USER1> Last-Used 24 Jan 20 07:47 System=XE91 Facility=DISPATCH     
TSS7001I Count=03186 Mode=Warn Locktime=None Name=<name>                       
IDMS DC258003 V1 USER <USER1> SIGNED ON LTERM VTMLT051 AT 08:26:04.31 20.024 
V1  Enter Next Task Code:                               


In the event of a password or password phrase expiration, users will have the ability to change/update their password or password phrase when the user is prompted to enter their current password or password phrase at logon. A new password must be from 1 to 8 characters in length and cannot include blank characters. A new password phrase can be from 9 to 100 characters long and can include mixed-case letters, numbers, and special characters including blanks. 

Password Expiration Example:

HI <USER1>
CADS - Enter External Security Password:  
OLDPW
TSS7110E Password Has Expired. New Password Missing    
CADS - Password Expired.  Enter New Password  
NEWPW
CADS - Reenter New Password for Verification      
NEWPW
TSS7030I Password Changed                                                    
TSS7000I <USER1> Last-Used 09 Dec 19 09:01 System=XE91 Facility=DISPATCH     
TSS7001I Count=03185 Mode=Warn Locktime=None Name=<name>                       
IDMS DC258003 V1 USER <USER1> SIGNED ON LTERM VTMLT051 AT 07:47:25.77 20.024 
 V1  Enter Next Task Code:                                                                                              
   
Password Phrase expiration Example:

HI <USER1>
CADS - Enter External Security Password:  
OLDPHRASE123
TSS7110E Password Phrase Has Expired. New Password Phrase Missing 
CADS - Passphrase Expired.  Enter New Passphrase                  
NEWPHRASE123
CADS - Reenter New Passphrase for Verification     
NEWPHRASE123
TSS7135I Password Phrase Changed         
TSS7000I <USER1> Last-Used 24 Jan 20 07:47 System=XE91 Facility=DISPATCH     
TSS7001I Count=03186 Mode=Warn Locktime=None Name=<name>                       
IDMS DC258003 V1 USER <USER1> SIGNED ON LTERM VTMLT051 AT 08:14:31.44 20.024 
V1  Enter Next Task Code:

Additional Information

* Note *

Passphrase logons via DRAS and via Web Viewer are not supported.