Passticket - Usage of PTKTDATA profile records

Products

• ACF2

Issue/Introduction

It might be needed to get the information of how many of the PTKTDATA profile records are being used, so this article aim to create a guide on how to do it, since this information is not stored on ACF2 databases.

Environment

Release : 16.0

Component : CA ACF2 for z/OS

Resolution

To get this information, the solution has two steps:

• First, setting up a SECTRACE, so any request of a PTKTDATA profile record will be registered; 
• Second, running the ACFRPTST utility to retrieve and format the data registered from SECTRACE.

Since the information will be gathered only while the SECTRACE is active, to have a better idea on which PTKTDATA profile records are being used, it is advisable to have the SECTRACE active for a long period of time and/or for different times of the day.

To restrict the type of data SECTRACE will collect, the parameter CLASS=PTKTDATA will be used. 

Setting up a SECTRACE

From the console, issue the following command:

SECTRACE SET,ID=iiii1,FMT=DUMP,TYPE=SAFP,END

where iiii1 should be a name of your choice.

This will generate a WTOR like this:

*0003 CAS21A0I SPECIFY RACROUTE PARAMETERS, CANCEL, OR END

and the reply should be:

r nnnn,REQUEST=EXTRACT,CLASS=PTKTDATA,END

To stop the SECTRACE, issue the following console command:

SECTRACE DEL,ID=iiii1

By default, the SECTRACE data will be recorded on active SMF dataset. For more information about SECTRACE options, please refer to Trace SAF Requests document.

Running the ACFRPTST Utility

This is a sample job to run ACFRPTST:

//REPORT  EXEC PGM=ACFRPTST                            
//SYSPRINT DD SYSOUT=*                                 
//RECMAN1  DD DISP=SHR,DSN=SYS1.MAN1                   
//RECMAN2  DD DISP=SHR,DSN=SYS1.MAN2                   
//RECMAN3  DD DISP=SHR,DSN=SYS1.MAN3                   
//SYSIN    DD *                                        
TITLE(SAMPLE ACFRPTST)                                 
DETAIL                                                 
ASID(****)                                             
/* 

                   

RECMAN1, RECMAN2 and RECMAN3 DDs should be the SMF datasets. The console command D SMF can be issued to make sure which are the SMF dataset names.

The generated report will be stored on the SYSPRINT DD.