Description of PTKTOOLS

Download count: 15 this month, 3049 altogether.
Downloads for PTKTOOLS:
  VMARC archive: v-34K

From Kris Buelens, IBM Belgium

Changes for V1.2:

  • Recognize the new "predefined" APPC resourceids FCXC1Snn and FCXC1Rnn
  • Use VMLINK instead of LNK to get access to the PERFKIT code.
  • An improved FCXRENAM EXEC.
  • Document how to avoid the "VM Systems Selection" panel if you do not use Central Monitoring.

I considered this a bit too small to make it a package, but demand made I changed my mind and make it available for download.

So, it is not a comprehensive set, but a collection composed of some control files and execs.

To look at the files, the easiest way is:

 FILEList PTKTOOLS PACKAGE * (FILEList
You will find:
  • Some PTK control files I used. Having them here makes it easier to reimplement a PTK setup, without having to dig in the manuals.
  • Some execs (the execs all have some comments inside them to give more information).
    PTK EXEC
    A very simple exec to send a command to PTK and see the result. Examples:
       ptk cpu             --> displays the CPU report
   ptk fc setevent     --> queries which events PTK has defined
    PTKCMS EXEC
    An exec to have PTK execute a CMS command and return the result to you. Examples:
       ptkcms q disk              --> gets the disks accessed by PTK
   ptkcms erase some file A   --> erases a file on PTK's A-disk
    PTK3270 EXEC
    Connects to the PERFSVM server, and allows you to look at the PTK performance report menus. Just as if you'd be logged on in the PERFSVM machine.

    PERFKIT can perform "central monitoring", that is one PERFSVM acts as a central point. A Systems menu is displayed. There are two ways connect to PERFSVM:

    • to the menu of managed systems, APPC resource FCXSYSTM
    • to the local z/VM system, APPC resource FCXRES00
    The APPC resource names can be changed using an UCOMDIR NAMES, a must when using an SSI cluster. IBM prepared respectively FCXC1S0n and FCXC1R0n in the CP directory.

    When both resources (systems and local) are active, PTK3270 tries to connect to the FCXSYSTM (we also recognize FCXC1Snn).Supposing you did set up Central Monitoring.

    If having only one system, or not wanting to set up Central Monitoring, you may want to bypass the system selection panel. Two method exists:

    1. you enter PRK3270 resid eg FTK3270 FCXC1R01
    2. avoid PERFKIT creates an FCXSYSTM (or FCXC1Snn). Easily done: code an entry in PERFSVM's UCOMDIR NAMES 
          :nick.FCXSYSTM :luname.*IDENT :tpn.nothing
    Note: if you coded UCOMDIR NAMES so that PERFSVM creates other resource names than FCXSYSTM, FCXRES00, FCXC1Snn and FCXC1Rnn, and PERFSVM creates more than 1 APPC resource, "PTK3270" will not start as it doesn't know what resource to select.

    FCXRENAM EXEC
    To store on PERFSVM's A-disk. It is meant to save and cleanup HISTLOG and CONLOG files on the 195 MDISK of PERFSVM. The larger the MDISK, the more files will be kept. It will ERASE the oldest files to make room to store the new files.

    FCONX $PROFSVM
    An FCONX $PROFILE for PERFSVM 191. Note: this is backlevel based, on some z/VM V5, use for consultation only. The statements must turn on performance monitoring.

    FCXRENAM EXEC
    An FCONX $PROFILE for PERFSVM 1CC, so used by end-users of e.g. PTK3270. Note: this is backlevel based, on some z/VM V5, use for consultation only. The statements must **not** turn on performance monitoring.

Note: for the first 3 execs, you need to be authorized in PTK. I store the FCONRMT AUTHORIZ file on PERFSVM's A-disk. 

 FCONRMT  AUTHORIZ H1  F 80  Trunc=
====>
|...+....1....+....2....+....3....+
* * * Top of File * * *
* node   userid   Authorizations
*----------------------------------
 *       PERFSVM  S&FSERV CMD DATA
 *       MAINT    CMD DATA
 *       VMUTIL   CMD DATA
 *       VMPRF    CMD DATA
 *       KRIS     CMD DATA
 *       BUELENSC CMD DATA
 *       VERBEKEN CMD DATA
 *       *        DATA

To end and as usage example of the above tools, here how I'd update the AUTHORIZ file. This procedure obviously only works after you have been authorized, that is, not the very first time.

  1. VMLINK PERFSVM 191 (FILEL Link and Access PERFSVM's 191 disk. So, we can XEDIT FCONRMT AUTHORIZ
  2. Issue FILE = = A to file the updated file to your A-disk.
  3. Issue SENDFILE FCONRMT AUTHORIZ A PERFSVM to send the updated file to the PERFSVM server.

    Now it becomes special.

  4. Get the spool file number of the file we sent to PERFSVM:
    CP FOR PERFSVM CMD Q R * ALL
Ready BUELENSC at BRUVMBRS ; T=0.01/0.01 11:42:42
PERFSVM  : ORIGINID FILE CLASS RECORDS  CPY HOLD DATE       TIME     NAME    TYPE
PERFSVM  : DIRMAINT 0949 A PUN 00000010 001 NONE 2012-01-18 00:01:04 PERFSVM BRUVMBRS
PERFSVM  : BUELENSC 0953 A PUN 00000014 001 NONE 2012-02-02 11:41:24 FCONRMT AUTHORIZ
PERFSVM  : HCPFOR069I Command Complete.  CP return code = 0000.
    Note: instead of CP FOR, you can also use ptkcms CP Q R * ALL
  5. The number of the FCONRMT AUTHORIZ file is 953, so tell PTK to RECEIVE it:
    ptkcms receive 953 = = a (replace
 FCX123      CPU 2084  SER 05530   Command executed :  11:43:00    Remote Data
 
 CMS PIPE (SEP @ ) CMS RECEIVE 953 = = A (REPLACE@INSERT /MSGNOH BUELENSC PERFS
 Stacked for execution
 
 PERFSVM: File FCONRMT AUTHORIZ A1 replaced by FCONRMT AUTHORIZ H1 received from BUELENSC at BRUVMBRS
Ready BUELENSC at BRUVMBRS ; T=0.01/0.01 11:43:13
  6. Tell PTK to re-read the FCONRMT AUTHORIZ file:
    ptk fc reload auth
Command complete
 
Ready BUELENSC at BRUVMBRS ; T=0.01/0.01 11:43:28