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 CTINFC
nn 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.