DUMP (FTP client and server) statement

Use the DUMP statement to activate an extended trace.

Restriction: Only one dump parameter can be specified for a DUMP statement.

Server: Extended traces are recorded on server's system for server debugging.
Client: Extended traces are recorded on client's system for client debugging.

Syntax


>>-DUMP--parameter---------------------------------------------><

Parameters

n

Specifies the ID number of a specific extended trace point that is to be activated in the FTP code. The number is an integer in the range 1 - 99.

FSC

Activates all of the extended trace points in the file services code.

JES

Activates all of the extended trace points in the JES services code.

Restriction: This applies to the server only.

SOC

Activates all of the extended trace points in the network services code.

SQL

Activates all of the extended trace points in the SQL services code.

ALL

This parameter is used to set all of the trace points. It sets dump IDs 1 to 99.

USERID (filter_name)

This parameter is used to filter the extended trace for user IDs matching the filter_name pattern. If the user ID matches the filter at the time the client logs in, tracing options are set to the current value of the options. Otherwise, no extended tracing options are set. The client might use the SITE command to set options after login if the initial ones are not appropriate. An example for the USERID filter is:

DUMP USERID(USER33)

which activates the dumpID trace for a user if the user ID is USER33.

Restriction: This applies to the server only.

IPADDR (filter/subnet mask)

This parameter is used to filter the extended trace for IP addresses matching the filter pattern. If the IP address matches the filter at the time the client connects, extended tracing options are set to the current value of the options. Otherwise, no extended tracing options are set. The client might use the SITE command to set options after connect if the initial ones are not appropriate. Examples of the IPADDR filter are:

DUMP IPADDR(9.67.113.57)
DUMP IPADDR(FEDC:BA98:7654:3210:FEDC:BA98:7654:3210)

The first example activates the extended traces for a client whose IP address is 9.67.113.57; the second activates the extended traces for a client whose IP address is FEDC:BA98:7654:3210:FEDC:BA98:7654:3210.

If the filter is an IPv4 address, submasking can be indicated by using a slash followed by a dotted decimal submask. For example, 192.48.32/255.255.255.0 allows addresses from 192.48.32.00 to 192.48.32.255. If the filter is an IPv6 address, network prefixing can be indicated by using a slash followed by a network prefix. For example, use FEDC:BA98::0/32 to indicate the prefix: FEDCBA98.

Restriction: This applies to the server only.