VTRACE    DSNAME(data-set-name)
          JOBNAME(job-name)
          HOOK(hook-id [,hook-id])
          PARM1(trace-parm-1)
          [PARM2(trace-parm-2)]
          [ECODE(ANY|rsncode)]
          [KEYVALUE(target-key-value) | KEYVALUE(x’target_key_value_hex’)]
          END			

VTRACE

Specifies the current entry is to define a VSAM record management trace entry.

DSNAME(data-set-name)

Specifies the base cluster name of the targeted data set. You can use the asterisk (*) as a pattern matching (wildcard) character. An asterisk matches zero or more characters when used with other characters, or one or more characters if used alone. For example, SMITH.TEST*.DATA would match SMITH.TEST.DATA as well as SMITH.TESTALL.DATA. SMITH.*.DATA would match SMITH.TESTALL.DATA, but not SMITH.DATA. To match zero or more characters for a data set name qualifier, specify two asterisks. For example. SMITH.**.DATA would match SMITH.DATA.

JOBNAME(job-name)

Specifies the job where the targeted data set was opened or will be opened.

HOOK(hook-id [,hook-id])

Specifies the list of VSAM predefined hook points which the trace should execute during VSAM record management processing.

PARM1(trace-parm1)

Specifies which control blocks VSAM record management trace should capture.

PARM2(trace-parm2)

Specifies which control blocks VSAM record management trace should capture when tracing the AIX®.

ECODE(ANY|rsncode)

Specifies tracing should occur only if an error code is being returned to the caller.

ANY

Tracing is performed for any nonzero return code.

rsncode

Tracing is preformed only if the RPLFDBK code matches rsncode.

KEYVALUE(target-key-value | x'target_key_value_hex')

Specifies tracing should occur only if the current processing key matched target-key-value or hexadecimal value x'target_key_value_hex'.

For a description of the subparameters, such as the values for HOOK, PARM1 and PARM2, see Subparameters for trace.