Teleview setup with RACF PassTicket

Document ID : KB000020618
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

This document describes the steps required to set up Teleview for use with RACF PassTicket.

Solution:

Ensure that PTF RO54792 has been applied to Teleview then follow these steps:

  1. Setup TSO RACF PTKTDATA class:

    RDEF PTKTDATA TSOsmfid UACC(NONE) OWNER(@PTKDAT) RALT PTKTDATA TSOsmfid AUDIT(FAILURES(READ)) RALT PTKTDATA TSOsmfid SSIGNON(KEYMASKED(0123456789ABCDEF))

    For the setup of RACF PTKTDATA Class, the RDEF and RALT can be combined as one RDEF instead of breaking it up into multiple commands of RDEF and RALT.

  2. Enable the following Teleview feature in VOPTIONS data set, member FEATURES:

    USE-EXTERNAL-SECURITY

  3. Modify TSO Application Sign On Exit (ASX), assemble and link-edit.

    Use #NTOKN for #FILLIN TEXT to fill in the obtained passticket:

    VASXTSO  #START LOGGING=NO,DEBUG=NO,ECHO=NO,PRINT=GEN,MAXCMDS=50          #VARLOG ERROR=RCV1              * Log all user variables RCV1     #RECEIVE ERROR=END              * GET FIRST SCREEN IMAGE          #SEARCH TEXT='IKJ56700A',NOTFOUN=RCV1,POSCUR=NO          #FILLIN TEXT=VZUIDL             * FILL THE TSO USER          #SEND ENTER                     * HIT ENTER RCV2     #RECEIVE ERROR=END * GET SIGNON PANEL          #SEARCH TEXT='TSO/E LOGON',NOTFOUN=END,POSCUR=NO          #FILLIN TEXT=#NTOKN             * PASSTICKET WILL BE OBTAINED          #SEND ENTER,ERROR=END           * HIT ENTER END      #END 


  • The TSO application must be defined exactly to CONFIG as follows:

    Sign on to Teleview as Administrator, select CONFIG.
    From the displayed panel select 1 and press ENTER To Continue.
    Next select 1 - Review.
    Next select 2 - Review Applications.

    This will put you in Screen 1 of the following display :

    -- Review Applications ---- CA-TELEVIEW Configuration - Screen 1) Applid   Applnum  Regid Menuname Type     LU0 LU2 AL I Hold Tag  -------- -------- ----- -------- -------- --- --- -- - ---- ---- TSOsmfid 000000nn  000  TSOsmfid TSO      Y   Y   N  Y PA2  NONE        (PF11= Scroll Right)  Screen 2)         Kybdlock Panlock Replay Routing Vtappl 1 Vtappl 2 Cmp Userdata        -------- ------- ------ ------- -------- -------- --- --------           ATTN       N   YES       C   TSOappl             N           (PF11= Scroll Right) Screen 3)        Le Loglim To Application Description   Sv Asx  Atx  Dr Sessproc        -- ------ -- ------------------------- -- ---- ---- -- --------         Y  00999 00 TSO on abnn                Y 03         N   
  • Notes:

    • APPLID must match the application name specified for the TSO PTKTDATA class.
    • VTAPPL 1 must match the VTAM APPLID used for the TSO application.
    • ASX suffix must match last two bytes for assembled exit. (For example, for the display above the corresponding exit name for Asx 03 would be VASX03).