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
>>-LOCSTat--| option |-----------------------------------------><
options
|--+-ASAtrans----------+----------------------------------------|
+-AUTOMount---------+
+-AUTORecall--------+
+-BLocks------------+
+-BLOCKSIze---------+
+-BUfno-------------+
+-CConntime---------+
+-CHKptint----------+
+-CHKPTPrefix-------+
+-CONDdisp----------+
+-CYlinders---------+
+-DATAClass---------+
+-DATACTtime--------+
+-DATAKEEPALIVE-----+
+-DATASetmode ------+
+-DB2---------------+
+-DBSUB-------------+
+-DCbdsn------------+
+-DCOnntime---------+
+-Directory---------+
+-DIRECTORYMode-----+
+-DSNTYPE-----------+
+-DSWAITTIME--------+
+-EATTR-------------+
+-ENcoding----------+
+-EPSV4-------------+
+-FIFOIOTIME--------+
+-FIFOOPENTIME------+
+-FILEtype----------+
+-FTpkeepalive------+
+-FWFriendly--------+
+-INacttime---------+
+-ISPFStats---------+
+-LISTSUBdir--------+
+-LRecl-------------+
+-MBdataconn--------+
+-MBREQUIRELASTEOL -+
+-MBSENDEOL---------+
+-MGmtclass---------+
+-MIGratevol--------+
+-MYopentime--------+
+-PASSIVEIGNOREADDR-+
+-PDSTYPE-----------+
+-PRImary-----------+
+-QUOtesoverride----+
+-RDw---------------+
+-READTAPEFormat----+
+-RECfm-------------+
+-RESTGet-----------+
+-RETpd-------------+
+-SBDataconn--------+
+-SBSENDEOL---------+
+-SBSUB-------------+
+-SBSUBChar---------+
+-SECondary---------+
+-SECUREIMPlicitzos-+
+-SPRead------------+
+-SQLCol------------+
+-STOrclass---------+
'-TLSRFCLEVEL-------'
|--+-TRacks---------------+-------------------------------------|
+-TRAILingblanks-------+
+-TRUNcate-------------+
+-UCOUNT---------------+
+-UCSHostcs------------+
+-UCSSub---------------+
+-UCSTrunc-------------+
+-UMask----------------+
+-UNICODEFILESYSTEMBOM-+
+-Unit-----------------+
+-UNIXFILETYPE---------+
+-VCOUNT---------------+
+-VOLume---------------+
+-WRAPrecord-----------+
'-WRTAPEFastio---------'
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.
- 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:
z/OS Communications Server: IP User's Guide and Commands
Copyright IBM Corporation 1990, 2013