Any RENAME command qualifier that is unlisted here is not sup-
ported.
1.5.3.1 /CONFIRM
/CONFIRM
/NOCONFIRM
This qualifier controls whether a request is issued before each
rename operation asking you to indicate whether to rename that
file. The local sytem prompts you by asking, "filename -> filename
? (Y,N,Q,All):."
Issue one of the following responses:
o To affirm renaming a specific file: Yes, True, or 1
o To prevent renaming a specific file: No, FALSE, 0, or <RET>
o To continue renaming without further confirmations: ALL
o To stop all renaming: Quit or <CTRL/Z>
Abbreviations and any combination of upper- and lowercase letters
are acceptable.
Default value: Unconfirmed
1.5.3.2 /LOG
/LOG
/NOLOG
This qualifier controls whether the FTAM renaming utility displays
the file specification of each file it renames.
Default value: No logging
1.5.4 – Examples
1. $ RENAME/APPLICATION_PROTOCOL=FTAM /CONFIRM -
_$ AMIGO::"/MAIN/SUB/FILE/EXT" AMIGO::"NEW/FILE" <RET>
AMIGO::"/MAIN/SUB/FILE/EXT" --> AMIGO::"NEW/FILE" ? (Y,N,Q,All):
Y<RET>
This command allows you to review your renaming request(s)
before they are executed. In this example, the remote file
/MAIN/FILE/EXT is renamed to the remote file /NEW/FILE on the
same system after the positive response (Y) is received.
2. $ RENAME/APPL=FTAM /CONFIRM /LOG FREUND::"^VOL>MAIN>FILE" -
_$ TEST.DAT <RET>
FREUND::"^VOL>MAIN>FILE.EXT" --> TEST.DAT ? (Y,N,Q,All): Y<RET>
%RENAME-I-RENAMED, FREUND::"^VOL>MAIN>FILE" renamed to TEST.DAT
This command requests conformation about renaming the remote
file ^VOL>MAIN>TEST.DAT on FREUND and, receiving a positive
response (Y), renames that file to TEST.DAT. The informational
message is displayed because the /LOG qualifier is used.
1.6 – SET
DECnet-Plus for OpenVMS provides additional functionality for the
HOST option of the SET verb.
1.6.1 – Set Options
These are the SET command options supplied by DECnet-Plus for
OpenVMS:
Option Function
HOST/MOP Connects your terminal to a remote system
by way of the current host processor using
the MOP protocol.
HOST/VTP Connects your terminal to a remote system
by way of the current host processor using
the OSI Virtual Terminal protocol.
HOST/X29 Connects your terminal to a remote system
by way of the current host processor using
the X.25 software and the CCITT X.29
protocols.
1.6.2 – HOST
Connects your terminal (through the current host processor) to
another processor, called the remote processor.
Format
SET HOST remote-system
1.6.2.1 – Parameter
remote-system
Specifies the name of the remote processor to which you will
connect.
1.6.2.2 /MOP
Connects your system to a remote system using the MOP protocol.
Format
SET HOST/MOP client-name
1.6.2.2.1 – Parameter
CLIENT
Specifies the name of the MOP CLIENT entity which describes
the remote system that is the target of the console carrier
request. This is an optional parameter. If omitted, you
must specify the /CIRCUIT and /ADDRESS qualifiers.
1.6.2.2.2 – Qualifiers
1.6.2.2.2.1 /ADDRESS=lan-address
Specifies the LAN address of the remote system.
1.6.2.2.2.2 /BREAK=break-character
Specifies the character which is to be recognized as a request
to send a MOP Break protocol command to the remote system.
Pressing the Ctrl key and this character transmits a MOP Break
to the remote system. The default character is \.
1.6.2.2.2.3 /CIRCUIT=circuit-name
Specifies the name of the MOP CIRCUIT entity over which the
request should take place.
1.6.2.2.2.4 /DISCONNECT=disconnect-character
Specifies the character which is to be recognized as a request
to terminate the connection with the remote system. Once the
connection is established, pressing the Ctrl key and this
character terminates the connection. The default character is ].
1.6.2.2.2.5 /VERIFICATION=hexidecimal-digits
Specifies the service password of the remote system. A
verification has 16 hex digits. If less than 16 digits are
specified, MOP will pad with zeros on the right.
1.6.2.3 /VTP
Connects your system to a remote system utilizing the OSI Virtual
Terminal Protocol.
Format
SET HOST/VTP alias
1.6.2.3.1 – Parameter
alias
Specifies the name of the remote VT application that you wish
to connect to. This name can be an alias in the
SYS$COMMON:[SYSEXE]ISOAPPLICATIONS.DAT file, or it can be the
X.500 Distinguished Name of the remote VT application enclosed
in quotes.
1.6.2.3.2 – Qualifiers
1.6.2.3.2.1 /BREAK
/BREAK=break-character
Selects the break character. The break character is used to
generate a break on lines that expect a break rather than a
carriage return. To generate a break, press Ctrl/break-character.
The break character can be any ASCII character between @ and z.
You cannot select a character currently defined as either the
command character (see the description of the /COMMAND=command-
character qualifier) or the disconnect character (see the
description of the /DISCONNECT=disconnect-character qualifier).
The ASCII characters between @ and z include the alphabetic
characters in both upper and lower cases, the "at" sign (@),
the backslash (\), the right bracket (]), the circumflex (^),
the underscore (_), and the grave accent (`).
By default, the break character is the right bracket (]).
1.6.2.3.2.2 /COMMAND
/COMMAND=command-character
Selects the command character. The command character is used to
access VT command mode by pressing Ctrl/command-character.
The command character can be any ASCII character between @ and z.
You cannot select a character currently defined as either the
break character (see the description of the
/BREAK=break-character qualifier) or the disconnect character
(see the description of the /DISCONNECT=disconnect-character
qualifier).
The ASCII characters between @ and z include the alphabetic
characters in both upper and lower cases, the "at" sign (@),
the backslash (\), the right bracket (]), the circumflex (^),
the underscore (_), and the grave accent (`).
By default, the command character is the "at" sign (@).
1.6.2.3.2.3 /DISCONNECT
/DISCONNECT=disconnect-character
Selects the disconnect character. The disconnect character is
used to abnormally terminate VT association with the remote
system by pressing Ctrl/disconnect-character.
The disconnect character can be any ASCII character between @
and z. You cannot select a character currently defined as
either the break character (see the description of the
/BREAK=break-character qualifier) or the command character (see
the description of the /COMMAND=command-character qualifier).
The ASCII characters between @ and z include the alphabetic
characters in both upper and lower cases, the "at" sign (@),
the backslash (\), the right bracket (]), the circumflex (^),
the underscore (_), and the grave accent (`).
By default, the disconnect character is the "backslash" (\).
1.6.2.3.2.4 /LOG
/LOG[=filespec]
/NOLOG (default)
Controls whether a log file of the entire session is kept. If you
use the /LOG qualifier without the file specification, the log
information is stored in the file SETHOST_VTP.LOG.
1.6.2.3.2.5 /PROFILE
/PROFILE=profile-name
Specifies the Virtual Terminal profile to be used when
establishing the association. The following profiles are
currently supported:
o Generalized_Telnet (default)
o Telnet
o Transparent
o Amode_default
1.6.2.3.2.6 /STATISTICS
/STATISTICS
/NOSTATISTICS (default)
Provides statistics on the VT association, including CPU usage,
pagefaults, and I/O counts.
1.6.2.3.3 – Example
$ SET HOST/VTP ITALIC
Username: BROWN
Password:
Welcome to VAX/VMS Version 5.4 on node ITALIC
.
.
.
$ LOGOUT
BROWN logged out at 19-APR-1991 15:04:25.27
%VT-S-END, Control returned to local end system
In this example, the name of the local node is CASLON. This SET
HOST/VTP command connects the user terminal to the processor at
the network node named ITALIC. The remote processor then prompts
for user name and password. Use the normal login procedure to
log in to the remote processor.
1.6.2.4 /X29
Enables a connection to a host-based PAD using the X.29 protocol.
Format
SET HOST/X29 node-name
When you are first connected to the PAD, your terminal is in
data-transfer mode. You can change to PAD command mode by typing
the appropriate escape character (usually <CTRL/P>). In command
mode you can obtain further help on the PAD (by typing HELP).
1.6.2.4.1 – Qualifiers
1.6.2.4.1.1 /BREAK_CHARACTER=character
/NOBREAK_CHARACTER
(Default=/NOBREAK_CHARACTER)
This qualifier sets up a control character which has the same
effect as entering the BREAK command. The character must be a
single letter representing a control character. For example,
if the character is K, <CTRL/K> acts as a BREAK key.
1.6.2.4.1.2 /CCITT
/NOCCITT
(Default=/NOCCITT)
If you use this qualifier and do not specify a DTE address you
may only use the /LOG, /PARAMETER, /VMS_MODE, /PROFILE,
/STATISTICS and /DEFAULT_ESCAPE_CHARACTER qualifiers. PAD will
accept only CCITT commands and an A command is used to make the
call.
If you specify a DTE address, you may use any of the qualifiers.
The PAD will make the call as requested and then enter CCITT
mode.
1.6.2.4.1.3 /CLOSED_USER_GROUP[=string]
/NOCLOSED_USER_GROUP
(Default=/NOCLOSED_USER_GROUP)
If this qualifier is present with a value, the value refers to
the name of the closed user group, and the parameter is the
usual DTE address.
When this qualifier is without a value, the DTE address parameter
is assumed to be the name of a bilateral closed user group.
1.6.2.4.1.4 /DEFAULT_ESCAPE_CHARACTER=character
/NODEFAULT_ESCAPE_CHARACTER
(Default=/DEFAULT_ESCAPE_CHARACTER=P)
This qualifier changes the control character you type to go into
PAD command mode.
Use this qualifier when accessing a PAD from a console terminal
(or on some other networking product) which interprets <CTRL/P>.
Do not enter <CTRL/P> from a console terminal unless you have set
the terminal to LOCAL DISABLE with the keyswitch. The keyswitch
is on the front of the system that you are using.
If you specify /NODEFAULT_ESCAPE_CHARACTER, you go into PAD
command mode by typing multiple <CTRL/Y>s ( or the host must set
parameter 1 to a value greater than 1 ).
1.6.2.4.1.5 /FACILITIES=(number-list)
/NOFACILITIES
(Default=/NOFACILITIES)
This qualifier specifies a list of numbers, in the range 0 to
255, which are in the 'local facilities field' in the NCB (refer
to the X.25 Programming Reference manual for details of the NCB).
This list specifies some local facility not covered by the X.25
software. This field is not checked so the network may reject
the call if you request an invalid facility.
1.6.2.4.1.6 /FAST_SELECT
/NOFAST_SELECT
(Default=/NOFAST_SELECT)
This qualifier makes the call with fast select requested.
1.6.2.4.1.7 /LOCAL_DTE=string
/NOLOCAL_DTE
(Default=/NOLOCAL_DTE)
The digit string specifies the local DTE address to use for the
outgoing call. This qualifier is not valid if you are using
X.25 Access.
1.6.2.4.1.8 /LOG[=file]
/NOLOG
(Default=/NOLOG)
This qualifier sets up a log file which logs copies of all the
data sent and received by the user.
This file is by default PSIPAD.LOG and is in the user's default
directory.
You can set the log file type in the PSI$PADLOG logical name to
either NETWORK or TERMINAL (the default). NETWORK captures data
on the network side of the host-based PAD, TERMINAL captures data
as it appears on your terminal.
Using the /LOG qualifier is the same as using the SET LOG
command which assumes the default /STAMP=SENSE. The /STAMP
qualifier has no effect on the TERMINAL log file.
1.6.2.4.1.9 /PACKET_SIZE=number
/NOPACKET_SIZE
(Default=/NOPACKET_SIZE)
Use this qualifier to request the specified packetsize in the
call packet. Otherwise, the network default is used. The
packetsize should be between 16 and 1024 and must be a power of
2. If you request a packetsize larger than the one configured,
X.25 will use the largest size configured.
1.6.2.4.1.10 /PARAMETERS=(parameter-list)
/NOPARAMETERS
(Default=/NOPARAMETERS)
The parameter-list consists of compulsory keywords and optional
values such as TIMEOUT=10, NOWRAP and DELETE. This qualifier is
the same as issuing a SET PARAMETER parameter-list command.
X.25 reads the parameter-list before you make your call.
1.6.2.4.1.11 /PROFILE=(profile-list)
/NOPROFILE
(Default=/NOPROFILE)
This qualifier is a list of profiles. It is the same as issuing
several "SET PROFILE profile-name" commands, one for each profile
name in the list.
1.6.2.4.1.12 /PROTOCOL_IDENTIFIER=string
/NOPROTOCOL_IDENTIFIER
(Default=/PROTOCOL_IDENTIFIER="01")
Use this qualifier to put a non-standard X.29 protocol identifier
string into the 'protocol identifier' field of the call. The
string is interpreted as a series of hexadecimal digits which
fill the first 4 bytes of user data in the call packet. Valid
values for this string are set up by the X.29 protocol.
1.6.2.4.1.13 /REVERSE_CHARGING
/NOREVERSE_CHARGING
(Default=/NOREVERSE_CHARGING)
Use this qualifier to request reverse charging in the call
packet.
1.6.2.4.1.14 /SUBADDRESS=string
/NOSUBADDRESS
(Default=/NOSUBADDRESS)
If you use this qualifier, the digit string you specify is a
local subaddress in the outgoing call.
1.6.2.4.1.15 /STATISTICS
/NOSTATISTICS
(Default=/STATISTICS)
This qualifier displays the duration of the PAD session at the
end of the call.
1.6.2.4.1.16 /THRUPUT_CLASS=number
/NOTHRUPUT_CLASS
(Default=/NOTHRUPUT_CLASS)
Use this qualifier to request the specified throughput class in
the call packet.
1.6.2.4.1.17 /USER_DATA=string
/NOUSER_DATA
(Default=/NOUSER_DATA)
Use this qualifier to specify a string of user data that is sent
to the remote DTE when the call is established. The maximum size
of the string is 12 characters, unless /FAST_SELECT has been
specified, in which case it is 124 characters.
1.6.2.4.1.18 /VMS_MODE
/NOVMS_MODE
(Default=/NOVMS_MODE)
This qualifier causes the PAD to enter VMS mode.
This optimizes communication with the remote DTE if the system is
VMS V4.0 or later. Do not use this qualifier unless you are
connected to a VAX/VMS V4.0 or later system.
1.6.2.4.1.19 /WINDOW_SIZE=number
/NOWINDOW_SIZE
(Default=/NOWINDOW_SIZE)
Use this qualifier to request the specified windowsize in the
range of 1-127 in the call packet. Otherwise, the network
default is used. If you request a windowsize larger than the one
configured, X.25 will use the largest size configured.
2 – FTAM
This help documents the FTAM product, which implements the
Open Systems Interconnection (OSI) File Transfer, Access and
Management (FTAM) protocol.
FTAM offers several user facilities that operate on any combination
of files on your system (local files) and on files on other systems
with FTAM applications (remote files). These facilities include:
o FTAM appending facility
This facility enables you to append files by using the
APPEND/APPLICATION_PROTOCOL=FTAM command. The facility allows
the appending of one or more input files to a single output
file, within or between FTAM applications.
o FTAM copying facility
This facility enables you to copy files by using the COPY/APPLICATION_
PROTOCOL=FTAM command. The facility allows the copying of one
or more input files to a single output file, within or between
FTAM applications.
o FTAM deletion facility
This facility enables you to delete files by using the
DELETE/APPLICATION_PROTOCOL=FTAM command.
o FTAM directory facility
This facility enables you to display file attributes for one
or more files by using the DIRECTORY/APPLICATION_PROTOCOL=FTAM
command.
o FTAM renaming facility
This facility enables you to rename files by using the
RENAME/APPLICATION_PROTOCOL=FTAM command.
2.1 – File-specification
The FTAM DCL commands accept any of the following file specifica-
tion formats:
rms-file-designation
appl-address::rms-file-designation
appl-address::"non-rms-file-designation"
appl-address"initiator-id password account"::rms-file-designation
appl-address"initiator-id password account"::"non-rms-file-
designation"
The following table describes the variables in these format state-
ments:
__________________________________________________________________
Variable Explanation
__________________________________________________________________
appl-address An FTAM application address that corresponds to the
FTAM responder of an FTAM system. An FTAM responder
handles incoming requests for files from FTAM users.
initiator-id A character string that identifies an initiator
ID on the specified FTAM node. If you specify this
string in a local file specification, FTAM uses
the initiator ID as the user name of an OpenVMS
account.
password A string that identifies an FTAM filestore password.
If you specifiy this string in a local file specifi-
cation, FTAM uses the filestore password as the
login password for the OpenVMS account identified by
the initiator ID.
account A string that identifies an FTAM account name. If
you specify this string in a local file specifi-
cation, FTAM uses it as an OpenVMS account name. To
specify an account, you must also specify both a
user name and a password.
rms-file- A standard Record Management Services (RMS) file
designation specification, which contains one or more components
in the following format:
(device-name:[directory-name]file-name.file-
extension;version-number).
Except for the file name or file name delimiter
(.), all the components are optional.
For local files, the FTAM copying facility per-
mits standard DCL wildcards. See the "Wildcards"
subtopic for more information about DCL wildcards.
non-rms- A file designation whose format RMS cannot inter-
file- pret. A non-rms file designation contains whatever
designation information the remote FTAM system requires for
locating a remote file. Enclosing non-RMS file des-
ignations between double quotation marks ("non-rms-
file-designation") causes RMS to accept the enclosed
designation without trying to parse it. Failing
to enclose non-rms file designations within double
quotation marks causes an error.
Note that FTAM cannot handle a remote file des-
ignation that contains one or more double quotation
marks among its characters.
__________________________________________________________________
File designations equate to FTAM file names. An FTAM file name
is a text string that identifies a file to an FTAM system. The
FTAM system requesting a file (the initiator) supplies an FTAM
file name to the FTAM system accepting the file request (the
responder).
FTAM treats FTAM file names as follows:
o When you request a remote file, the FTAM initiator separates
the FTAM application address from the file designation. The
application address translates into the address of an FTAM
application on a particular FTAM system. The file designation,
which includes everything to the right of the double colons
(::) excluding double quotation marks that enclose an FTAM
file designation, serves unchanged as an FTAM file name.
o When processing an incoming file request, the FTAM responder
treats whatever string it receives for the FTAM file name
as an RMS file designation.
3 – MOP
Connects your system to a remote system using the MOP protocol.
4 – X.25
The X.25 software is the interface for packet switching data
networks (PSDNs).
5 – VTP
Virtual Terminal software is a communications component for
terminal access between open systems.
Virtual Terminal may act as the initiator/terminal (for a local
user) or as the responder/host (for the remote user).
Supported Standards:
Virtual Terminal conforms to the following ISO standards:
o ISO 9041 - Virtual Terminal Protocol - Basic Class
o ISO 8650 - ACSE protocol
o ISO 8823 - Presentation protocol
o ISO 8327 - Session protocol
Virtual Terminal Features:
o Class of Service
- Basic class (character cell terminals)
o Mode of Operation
- Asynchronous Mode (A-Mode)
o Profile Support
- Default A-Mode
- Telnet-1988 (A-Mode)
- Transparent (A-Mode)
- Generalized Telnet (A-Mode)
o Functional Units
- Break
o Supported Gateways
- Bidirectional VT/LAT
- Bidirectional VT/Telnet
Tracing Utility:
The Virtual Terminal tracing utility, provided by
SYS$COMMON:[SYSEXE]OSITRACE.EXE, is a tool for identifying problems
in protocol exchanges between your local system and any remote
system. The tracing utility captures protocol exchanges and
transcribes them into easily readable text.
The Virtual Terminal tracing utility monitors data exchanges for
individual associations. The tracing utility can trace data
originating from the following components: VT, ACSE, Presentation,
and Session.