How to add STX Administrator authority?

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

Description:

CA TPX and CA STX share a common administration structure.

CA-N-Vision/STX was an advanced ACF/VTAM application that addressed the problems associated with accessing an X.25 network. It allowed a 3270 terminal user to access applications on an X.25 network via the SNA host.

(Support for STX was dropped in 2010.)

Solution:

While a customer does not need to be licensed (authcode or LMP code) for STX, STX structures can still be created and copied from userid to userid within TPX (especially on static users). They can be created by selecting STX options by mistake and not cancelling out, but backing out. In this case, a STX structure is created even if no data is entered on the STX side.

Thus, an ADMINISTRATOR needs both TPX and STX ADMIN capabilities all set to Y in order to be able to delete such a userid.

TPX was delivered with several predefined userids:

  • TPXADMIN is a default TPX administrator
  • NVIADMIN is a default STX administrator
  • STXADMIN is another STX administrator

If you can sign on with userid NVIADMIN or STXADMIN, you can grant STX Admin authority to additional userids:

  • Verify that NVIADMIN is authorized to administer these users' group, for example, TPXGROUP.

  • Under User maintenance, select the userids and set the STX Administrator fields to Y. (panel TEN0169--user maintenance admin capabilities)
TPX User Administrator:        Y        STX User Administrator:        Y
TPX Master Administrator:       Y       STX Master Administrator:       Y
TPX System Administrator:       Y       STX System Administrator:       Y
TPX Operator Administrator:      Y

After saving these changes to your userids by NVIADMIN, the updated users will need to sign off/on to pick up the changes.

Here is a sample batch job to identify if any users at your site have STX administrator authority:

C
C  extract from USER records if user has any STX Admin authority
C           (may have duplicate report lines)
C  multiple EXTRACT statements with DISP=MOD on DD
C
EXTRACT GIVING(EXTFILE) USER AND NO SESSIONS (UIDXCMSX(Y))
EXTRACT GIVING(EXTFILE) USER AND NO SESSIONS (UIDXCSYX(Y))
EXTRACT GIVING(EXTFILE) USER AND NO SESSIONS (UIDXCADX(Y))
SET RTITLE1 ' ========  === STX ADMIN AUTH === '
SET RTITLE2 '  USERID   MASTER   SYSTEM   USER '
SET RTITLE3 ' ========  ======   ======   ==== '
REPORT GIVING(RPTFILE) USING (EXTFILE)
     ((' &UIDXNAME' ' &UIDXCMSX' '&UIDXCSYX' '&UIDXCADX' ))
 
Sample report:
 
========  === STX ADMIN AUTH ===
USERID   MASTER   SYSTEM   USER
========  ======   ======   ====
NVIADMIN  Y        Y        Y
STXADMIN  Y        Y        Y
NVIADMIN  Y        Y        Y
STXADMIN  Y        Y        Y
NVIADMIN  Y        Y        Y
STXADMIN  Y        Y        Y

(NOTE: A userid will show up once for each type of authorization that they are assigned. If desired, you may write this report to a file and sort to eliminate duplicate lines.)

In case NVIADMIN and STXADMIN have been deleted from your TPX system, here is a TPX batch example to add STX Administrator Authority to a userid, including reports before and after the change:

//BATCHADM EXEC TPX,VNODE='*BATCH*'   
//*
//EXTFILB  DD UNIT=SYSDA,SPACE=(CYL,(1,1)),DISP=(MOD)
//RPTFILB  DD SYSOUT=*
//*
//EXTFILE  DD UNIT=SYSDA,SPACE=(CYL,(1,1)),DISP=(MOD)
//RPTFILE  DD SYSOUT=*
//*
//SYSIN DD *
C
C  REPORT BEFORE
C
EXTRACT GIVING(EXTFILB) USER AND NO SESSIONS (UIDXCSYX(Y))
SET RTITLE1 ' ========  === STX ADMIN AUTH === BEFORE'
SET RTITLE2 '  USERID   MASTER   SYSTEM   USER '
SET RTITLE3 ' ========  ======   ======   ==== '
REPORT GIVING(RPTFILB) USING (EXTFILB)
     ((' &UIDXNAME' ' &UIDXCMSX' '&UIDXCSYX' '&UIDXCADX' ))
C
C  update userid with STX Admin authority
C
UPDATE USER (GVTEST1 (UIDXCMSX(Y) UIDXCSYX(Y) UIDXCADX(Y)))
C
C  REPORT AFTER
C
EXTRACT GIVING(EXTFILE) USER AND NO SESSIONS (UIDXCSYX(Y))
SET RTITLE1 ' ========  === STX ADMIN AUTH === AFTER'
SET RTITLE2 '  USERID   MASTER   SYSTEM   USER '
SET RTITLE3 ' ========  ======   ======   ==== '
REPORT GIVING(RPTFILE) USING (EXTFILE)
     ((' &UIDXNAME' ' &UIDXCMSX' '&UIDXCSYX' '&UIDXCADX' ))

Sample output:

========  === STX ADMIN AUTH === BEFORE
USERID   MASTER   SYSTEM   USER
========  ======   ======   ====
NVIADMIN  Y        Y        Y
STXADMIN  Y        Y        Y
========  === STX ADMIN AUTH === AFTER
USERID   MASTER   SYSTEM   USER
========  ======   ======   ====
GVTEST1   Y        Y        Y
NVIADMIN  Y        Y        Y
STXADMIN  Y        Y        Y