Starting component tracing for the z/OS NFS client

To start recording diagnostic information for the z/OS NFS client in z/OS component trace buffers, follow these steps:

Decide on the trace options to use. These can be in a CTINFCnn member of SYS1.PARMLIB to be specified on the TRACE CT command, or individual options to be specified when prompted in response to the TRACE CT command. Note that if TRACEOPTS OFF is used, no other TRACEOPTS value can be specified. See z/OS MVS Initialization and Tuning Reference for further information.
From the master console or another console with master authority, issue the TRACE CT command as follows:


>>-TRACE CT,ON,COMP=--mvsnfsc--+----------------+--------------><
                               '-,parm=CTINFCnn-'

where

mvsnfsc: Specifies the name of the procedure in your system PROCLIB used to start up the client.
parm=CTINFCnn: Specifies that diagnostic information for the NFS client be recorded in z/OS component trace buffers using trace options specified in member CTINFCnn of SYS1.PARMLIB. To use the default trace options for the z/OS NFS client, specify parm=CTINFC00 for the default SYS1.PARMLIB member CTINFC00.

If you do not specify a CTINFCnn PARMLIB member on the CTRACE CT command, the following message will prompt you to enter trace operands:

* id ITT006A SPECIFY OPERAND(S) FOR TRACE CT COMMAND.

In response to the message, reply with the identification number id from the message, an external writer program if any to receive the records, and a trace option or options to use from the list shown later in this section. Here is the response syntax:


>>-R(eply)--id--OPTIONS=--(name,name...)------------------------>

>--+----------------------+--+-,CONT-+-------------------------><
   '-,WTR=-+-procname---+-'  '-,END--'   
           '-DISCONNECT-'

where:

id

Specifies the identification number from the ITT006A message.

name,name...

Specifies a trace option or options for tracing NFS client records. The possible options are:

Buffer: Buffer management (BUFNODE)
CB_Mgmt: Control Block Management (creation, initialization, modification, deletion).
Detail: Detailed Trace Record. This is used for low level debug.
Dispatch: Unit of work is dispatched from a queue to resume processing.
Entry: Entry into a function
Exit: Exit from a function.
FFDC: First Failure Data Capture. This option is on by default and cannot be turned off.
General: General Trace Record.
Lock_Release: Control block lock release
Lock_Request: Control block lock requests
Lock_Resume: Control block lock request resumes after lock request either succeeds or fails.
Msg: Existing NFS Trace Error, Warning and Informational Records. This option is on by default and cannot be turned off.
Network: Network communication related trace.
NFS_Request: Request sent to NFS server.
NFS_Return: Return from NFS request.
Resume: Unit of work resumed due to availability of resource (for example, latch acquired).
Schedule: Unit of work is scheduled onto another queue (for example, ipcqueue of this or another task, array queue.).
Suspend: Unit of work must suspend due to unavailability of resource (for example, waiting for a latch).
Trap: For use in special temporary trap code created to aid in the analysis of a problem.
USS_Request: Request issued to z/OS UNIX System Services.
USS_Return: Returned from z/OS UNIX System Services request.

In addition to these basic options, you can also enter the following shorthand values to specify multiple record types:

All: All record types.
Call: Entry and Exit record types.
Lock: Lock_Request, Lock_Result, and Lock_Release record types.
NFS: NFS_Request and NFS_Return record types.
Task_Flow: Suspend, Resume, Schedule, and Dispatch record types.
USS: USS_Request and USS_Return record types.

Note:

An option can be turned off by preceding the option value with a minus sign (for example, OPTIONS=(-GENERAL) ).
Options are processed from left to right, first processing all values to turn on options and then processing all values to turn off options. Thus all options except Network can be turned on with the following specification: OPTIONS=(ALL, -NETWORK).
If an option value of -ALL is specified, only the minimum set of options remains active (FFDC and MSG).

WTR=procname|DISCONNECT

Connects or disconnects the component trace external writer and the trace. procname identifies the name of the member that contains the source JCL that invokes the external writer. The member can be a SYS1.PROCLIB cataloged procedure or a job. The procname in the WTR parameter must match the procname in a previous TRACE CT,WTRSTART command.

WTR=DISCONNECT disconnects the writer and the trace. The component continues tracing and placing the trace records in the address-space buffer, but stops passing trace records to the external writer.

You must also specify a TRACE CT,WTRSTART or TRACE CT,WTRSTOP command to start or stop the writer.

CONT or END

Specifies that the reply continues on another line. The system reissues the same prompting message. You then can continue the reply. You can repeat any parameters on the continuation line, except END. Repeated parameters are strung together. They do not overlay each other. You must specify END to complete the response. END identifies the end of the REPLY.