LOCSTat subcommand—Display local status information
Purpose
Use the LOCSTat subcommand to display local status information.
Tip: Issuing the LOCSTat
subcommand with no parameters causes all local status to be displayed.
To display local status for a single configuration option, issue
the LOCSTat subcommand with at least one parameter.
Format
Parameters
- ASAtrans
- Indicates that the FTP client interprets characters in the first column of ASA files that are being transferred as print control characters.
- AUTOMount
- Indicates automatic mounting of volumes for data sets that are on unmounted volumes.
- AUTORecall
- Indicates automatic recall of migrated data sets.
- BLocks
- Indicates that primary and secondary space allocations are in blocks.
- BLOCKSIze
- Indicates the block size of a newly allocated data set.
- BUfno
- Indicates the number of access method buffers that is used when data is read from or written to a data set.
- CConntime
- Indicates the length of time that the FTP client waits after attempting to close a control connection before terminating it and reporting an error.
- CHKptint
- Indicates the checkpoint interval for the sending site in a file transfer request.
- CHKPTPrefix
- Indicates a key that is used to determine the high-level qualifier of the checkpoint data set.
- CONDdisp
- Indicates the disposition of the data set if a retrieve operation for a new data set ends before all of the data is written.
- CYlinders
- Indicates that primary and secondary space allocations are in cylinders.
- DATAClass
- Indicates the SMS data class.
- DATAKEEPALIVE
- Indicates the number of seconds that TCP/IP waits before sending
a keepalive packet while the data connection is inactive.
The value 0 indicates that the DATAKEEPALIVE timer is disabled. For passive mode data connections, the keepalive timer that you configured in PROFILE.TCPIP controls how often keepalive packets flow on the data connection. For active mode data connections, FTP suppresses the PROFILE.TCPIP keepalive timer.
- DATACTtime
- Indicates the length of time that the FTP client waits after attempting to send or receive data before terminating the connection and reporting an error to the user.
- DATASetmode
- Indicates whether DATASetmode or DIRECTORYMode is in effect.
- DB2®
- Indicates the name of the Db2® subsystem.
- DBSUB
- Indicates that substitution is allowed for data bytes that cannot be translated in a double-byte character translation.
- DCbdsn
- Indicates the name of the MVS™ data set to be used as a model for allocating new data sets.
- DCOnntime
- Indicates the amount of time that FTP waits attempting to close a data transfer before terminating the connection and reporting an error.
- Directory
- Indicates the number of directory blocks to be allocated for the directory of a partitioned data set (PDS).
- DIRECTORYMode
- Indicates whether DATASetmode or DIRECTORYMode is in effect.
- DSNTYPE
- Indicates the data set name type for new physical sequential data
sets.
- SYSTEM
- Physical sequential data sets are allocated with the SMS data class value. If no data class is defined, or if the DSNTYPE attribute is not defined, new physical sequential data sets will be allocated with the system default value.
- BASIC
- Allocates physical sequential data sets as physical sequential basic format data sets.
- LARGE
- Allocates physical sequential data sets as physical sequential large format data sets.
- DSWAITTIME
- Indicates the number of minutes the FTP client waits for an MVS data set to become available when a local data set is held by another job or process. The value 0 indicates that the FTP client does not wait to obtain a data set when the data set is held by another job or process.
- EATTR
- Indicates whether newly allocated data sets can have extended
attributes and whether new data sets can reside in the EAS of an EAV.
The value of EATTR is one of the following values:
- SYSTEM
- The data set uses the SMS data class EATTR value. If no SMS data class is defined, or if the data class contains no EATTR specification, the data set is allocated with the system default.
- NO
- The data set cannot reside in the EAS, and its VTOC entry cannot contain extended attributes.
- OPT
- The data set can reside in the EAS, and its VTOC entry can have extended attributes if the volume supports them.
- ENCODING
- Indicates the kind of encoding that is used for conversions between code pages for data transfers.
- EPSV4
- Indicates that the client will attempt to use the EPSV command to establish a data connection on an IPv4 session instead of referring to the FWFRIENDLY setting.
- FIFOIOTIME
- Indicates the length of time that the FTP client waits for a read from a z/OS® UNIX named pipe or for a write to a z/OS UNIX named pipe to complete.
- FIFOOPENTIME
- Indicates the length of time that the FTP client waits for an open of a z/OS UNIX named pipe to complete.
- FILEtype
- Indicates the file type of the data set.
- FTpkeepalive
- Indicates the control connection keepalive timer value in seconds.
- FWFriendly
- Indicates that the FTP client is firewall-friendly.
- INacttime
- Indicates the length of time that the FTP client waits for an expected response from the server, on either the control or the data connection, before closing the session.
- ISPFSTATS
- Indicates whether FTP will create or update ISPF Member statistics when Get or MGet subcommands are issued.
- LISTSUBdir
- Indicates that wildcard searches should apply to the current working directory and should also span its subdirectories.
- LRecl
- Indicates the logical record length (LRecl) of a newly allocated data set.
- MBDATACONN
- Indicates the code pages for the file system and for the network transfer that are used when the client does data conversion during a data transfer.
- MBREQUIRELASTEOL
- Indicates whether the last record of an incoming multibyte transfer
is required to have an EOL sequence.
- TRUE
- A missing EOL on the last record received is treated as an error.
- FALSE
- A missing EOL on the last record received is ignored.
- MBSENDEOL
- Indicates which end-of-line sequence to use when the ENCODING value is SBCS, the data is ASCII, and data is being sent to the server.
- MGmtclass
- Indicates the SMS management class.
- MIGratevol
- Indicates the volume ID for migrated data sets if they do not use IBM® storage management systems.
- MYopentime
- Indicates the length of time that the FTP client waits for a session to open before terminating the attempt and reporting an error.
- PASSIVEIGNOREADDR
- Indicates whether the FTP client should ignore the IP address in the FTP server PASV reply for the data connection and use the IP address that was used to log in to the FTP server.
- PASSIVEONLY
- Indicates whether the data connections for the client are passive mode only.
- PDSTYPE
- Indicates whether the FTP client creates local MVS directories as partitioned data sets or as partitioned data sets extended.
- PRImary
- Indicates the number of tracks, blocks, or cylinders for the primary allocation.
- QUOtesoverride
- Indicates that a single quotation mark (') at the beginning and end of a file name should override the current working directory instead of being appended to the current working directory.
- RDW
- Indicates that variable record descriptor words (RDWs) are treated as if they are part of the record and are not discarded during FTP transmission of variable format data sets.
- READTAPEFormat
- Indicates information about an input data set on tape.
- RECfm
- Indicates the data set record format.
- RESTGet
- Indicates that opening the checkpoint data set for the Get request is allowed.
- RETpd
- Indicates the number of days that a newly allocated data set should be retained.
- SBDataconn
- Indicates the conversions between file system and network code pages to be used for data transfers.
- SBSENDEOL
- Indicates which end-of-line sequence to use when ENCODING is SBCS, the data is ASCII, and data is being sent to the client.
- SBSUB
- Indicates that substitution is allowed for data bytes that cannot be translated in a single byte character translation.
- SBSUBCHAR
- Indicates the value that is used for substitution when SBSUB is also specified.
- SECondary
- Indicates the number of tracks, blocks, or cylinders for a secondary allocation.
- SECUREIMPlicitzos
- Indicates that when the client connects using the TLSPORT implicit
connection, the client waits for the
220 good morning
reply before initiating the security handshake and negotiation. - SPRead
- Indicates that the output is in spreadsheet format when the file type is SQL.
- SQLCol
- Indicates the SQL output file column headings.
- STOrclass
- Indicates the SMS storage class.
- TLSRFCLEVEL
- Indicates the level of RFC 4217, On Securing FTP with TLS, that is supported by the client.
- TRacks
- Indicates that primary and secondary space allocations are in tracks.
- TRAILingblanks
- Indicates that the FTP client preserves the trailing blanks in a fixed-format data set when the data is sent to a foreign host.
- TRUNcate
- Indicates that truncation is permitted.
- UCOUNT
- Indicates how many devices to allocate concurrently to support the allocation request.
- UCSHOSTCS
- Indicates the EBCDIC code set to be used when converting to and from Unicode.
- UCSSUB
- Indicates that in Unicode-to-EBCDIC conversion, the EBCDIC substitution character is used to replace any Unicode character that cannot be successfully converted.
- UCSTRUNC
- Indicates that in Unicode-to-EBCDIC conversion, EBCDIC data truncation is allowed.
- UMask
- Indicates the file mode creation mask.
- UNICODEFILESYSTEMBOM
- Indicates whether the FTP client stores incoming Unicode files with a byte order mark.
- UNIXFILETYPE
- Indicates whether the FTP client treats files in its z/OS UNIX file system as regular files or as z/OS UNIX named pipes.
- Unit
- Indicates the unit type for allocation of new data sets.
- VCOUNT
- Indicates the number of tape data set volumes that an allocated data set can span.
- VOLume
- Indicates the volume serial number for allocation of new data sets.
- WRAPrecord
- Indicates that data is wrapped to the next record if no new-line character is encountered before the logical record length of the receiving file is reached.
- WRTAPEFastio
- Indicates that ASCII stream data that is being written to tape can be written using BSAM I/O.
Examples
The following is an example of
the output from the LOCSTat subcommand, issued with a single parameter:
Command: locstat dconntime
DCONNTIME is 120
Command:
The following example shows part of the output from a LOCSTat subcommand.
Command: locstat
Trace: FALSE, Send Port: TRUE
Send Site with Put command: TRUE
Connected to:9.42.104.38, Port: FTP control (21), logged in
local site variable DSWAITTIME is set to 0
VCOUNT is 59
Prompting: ON, Globbing: ON
ASA control characters transferred as ASA control characters
New data sets catalogued if a store operation terminates abnormally
Single quotes will override the current working directory
UMASK value is 027
Data connections for the client are not firewall friendly.
local site variable EPSV4 is set to TRUE
local site variable SECUREIMPLICITZOS is set to TRUE
local site variable PASSIVEIGNOREADDR is set to FALSE
local site variable TLSRFCLEVEL is set to RFC4217
local site variable READVB is set to LE
local site variable EXTDBSCHINESE is set to TRUE
local site variable LISTSUBdir is set to TRUE
local site variable PROGRESS is set to 10
local site variable SEQNUMSUPPORT is set to FALSE
local site variable UNIXFILETYPE is set to FILE
local site variable FIFOIOTIME is set to 20
local site variable FIFOOPENTIME is set to 60
local site variable EATTR is set to SYSTEM
local site variable DSNTYPE is set to BASIC
Authentication mechanism: None Local Port: 1118
Tape write is not allowed to use BSAM I/O
Using /etc/ftp.data for local site configuration parameters.
Command: