Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Defines the attributes of a remote environment with NS3000/XL.
[[]] DSLINE [[][ =] ][;dslineoption]... [[] ]
The environment id is a character string that represents a specific session on a remote node. The environment name itself may optionally be qualified [. [. ]]. Each portion of the string may have a maximum of 16 alphanumeric characters, of which the first must be alphabetic. The characters "-" and "_" are also allowed. The default and names are those specified for your local node when it was configured as part of the NS network. For ARPA domain names, the environment ID has syntax label[.label[...]. The label must follow the syntax for ARPANET host names. The invID for ARPA domain names will not be fully qualified. An can be a generic environment id representing a set of environments. A generic environment id can include the MPE/iX wildcard characters @, #, and ?. @ stands for zero or more alphanumeric characters, # for one numeric character, and ? for one alphanumeric character. The attributes specified for a generic environment id are used as defaults for all matching environments, including environments defined later from the same local session, unless overridden in a later DSLINE command. These defaults can be reset by the RESET option, which is described below. DEFAULT either the specified (which then becomes an environment id) or, if no is specified, the environment specified by the last DSLINE or REMOTE command. If the communications link to the remote system is an NS link, is the name assigned to the remote node when it was configured into NS network. This name may optionally be qualified in the form [. [. ]]. The default and are those of the local node. Each portion of this string may have a maximum of 16 alphanumeric characters, of which the first must be alphabetic. The characters "-" and "_" are also allowed. If a customer uses ARPA domain names, then the node name syntax will be label[.label][...]. The label must follow the syntax for ARPANET host names. An environment id may be equated with this node name, or the node name (if used alone) may become its own environment id. In either case the environment id then represents a specific remote session on this node. DEFAULT the environment specified by the last DSLINE or REMOTE command. The number of the environment assigned when the environment was defined. This is the environment number that is displayed after a DSLINE command is issued. An option applicable to Network Service environments only. Any of the following options may be used. QUIET Ensures that no logon message is displayed when you log on to the remote environment, no logoff message is displayed when you log off, no environment messages are displayed when you log off, and no environment messages are displayed when a DSLINE command is executed. COMP Enables or disables data compression to the remote or environment. The compression affects VT, RFA, NFT, and NOCOMP PTOP transmissions if the link between nodes is a DS- compatible link, or NFT only if the link is an NS link. If data compression is in effect, sequences of repeated characters (such as blanks) are translated into a more compact form before transfer. They are decompressed after arrival at their destination. The default is NOCOMP. CLOSE Deletes the environment id(s) associated with the remote environment(s). This option must be used without any other option. RESET Clears all information associated with a generic environment id. This option must be used without any other option. SHOW Requests that the attributes of a remote environment (individual or generic) be displayed. SERVICES Requests that the status of the services available on a remote environment be displayed. PROMPT= Specifies a prompt for the remote environment. This can be used to distinguish one remote environment from another. The prompt string can be 1-8 characters long, optionally surrounded by quotation marks. All characters are allowed, but if the string contains a semicolon or the ASCII value representing a , the string must be in quotes for example, "my;node". You can also use quotation marks to include a blank at the end of a prompt string. Default: the first seven letters of the (unqualified) environment name or, if the environment name has fewer than seven letters, the whole environment name terminated by #. If you specify PROMPT= without a prompt string, the prompt becomes the normal local prompt from the remote operating system. The prompt specified with PROMPT= may be overridden by a prompt specified with the SETVAR command (SETVAR HPPROMPT) on a remote MPE/XL based system. LOGON= Specifies a logon sequence for the remote system which can be used by NFT, RFA, and RPM to create a temporary session on the remote node. The logon sequence must include all necessary passwords, and must be delimited by quotation marks if it contains characters that might cause the system to incorrectly interpret the logon string. TRACE= Enables or disables tracing to the remote environment. You can trace the messages sent by any Network Service (VT, NFT, etc.) between your local session and the remote environment. The trace records the actual message traffic for each intrinsic call or interactive request, including both Network Service headers and user-supplied data. You can also trace Transport Layer protocol activity supporting this Network Service traffic. Other levels of tracing are available through Network InterProcess Communication and Node Management Services. The specific parameters are {[ON][, ][,file][,recs][,maxdata][,TRANS]} {[OFF][,service]} NOTE A comma MUST precede a parameter whenever (a) that parameter is included or (b) that parameter is omitted and any OTHER parameter which follows is included. The parameter can be VT, RFA, RDBA, NFT, RPM, PTOP, or ALL. This parameter enables you to activate or deactivate tracing for one or all Network Services. The other parameters have the following meanings The name of a new or existing MPE file in which the trace is to be stored. If this parameter is omitted, the trace information is sent to a default file named TRxxxxxx, where TR is followed by the six leading characters of the remote environment id. The number of records allotted to a new trace file. DEFAULT 1024. The maximum amount of data to be traced on an individual send or receive request, a value from 0 to 8000 bytes. DEFAULT 2000 bytes. TRANS Requests tracing of Transport Layer protocol activity, specifically headers and internal messages.
The DSLINE command defines the attributes of a remote environment. These attributes are used when you log on to the remote node by issuing a REMOTE HELLO command or when NFT, RFA, or RPM creates a temporary remote session with the logon sequence specified in the DSLINE logon option. The connection is not established until you first use a network service (for example, when you issue a REMOTE HELLO). In order to establish a remote environment, you must equate an environment id with the actual node name or use the node name by itself, in which case the node name becomes the environment id. The environment id then represents a specific session on the remote node. If you are connected to the remote node by an NS link, you can use different environment ids to represent different sessions on the same node. Subsequent DSLINE commands can use an individual or generic environment id or an environment number to identify the remote environment(s). If node name, environment id, and environment number are all omitted, the default is the last environment referenced by a DSLINE or REMOTE command. (If this command uses a generic environment id, the new default environment becomes the last individual environment listed in the environment message then displayed. See below.) After a DSLINE command has been executed, a message is printed which identifies all the affected environment(s). For each environment, this message identifies the assigned environment number (in order of environments defined), the fully qualified environment id, and the fully qualified node name (if different from the environment id). If the command specifies attributes for a generic environment id, the generic environment id is listed separately in the returned message, and identified by the words GENERIC ENVIRONMENT. (Generic environments are given a separate number in the sequence of environments, but this number is not listed.) If the command uses a generic environment id but does not specify attributes, a separate generic environment is not listed since no new environment (with new default attributes) is being defined.
DSLINE SHAKESPEARE {default domain and } ENVIRONMENT 1 SHAKESPEARE.DCL.IND {organization } DSLINE S2=SHAKESPEARE;PROMPT=S2> {second session on } ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {same remote node } DSLINE HAMLET;TRACE=ON,ALL {traces NS activity } TRACE FILE FOR ALL SERVICES TO HAMLET.DCL.IND IS HAMLET.PUB.DSUSER ENVIRONMENT 3 HAMLET.DCL.IND DSLINE S@;LOGON=MGR.DSUSER {sets logon for } ENVIRONMENT 1 SHAKESPEARE.DCL.IND {multiple environments} ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND GENERIC ENVIRONMENT S@.DCL.IND DSLINE S2;SHOW {displays environment } ENVIRONMENT # 2 {information } ENVIRONMENT ID S2.DCL.IND NODE NAME SHAKESPEARE.DCL.IND LOGON MGR.DSUSER LOGGED ON NO PROMPT S2> ESTABLISHED BY DSLINE
DSLINE @ {lists all environments} ENVIRONMENT 1 SHAKESPEARE.DCL.IND {within default domain } ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {and organization } ENVIRONMENT 3 HAMLET.DCL.IND GENERIC ENVIRONMENT S@.DCL.IND DSLINE {returns default } ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {environment } DSLINE @;CLOSE {deletes environment } ENVIRONMENT 1 SHAKESPEARE.DCL.IND {ids and numbers and } ENVIRONMENT 2 S2.DCL.IND=SHAKESPEARE.DCL.IND {closes trace files } ENVIRONMENT 3 HAMLET.DCL.IND TRACE FILE FOR ALL SERVICES TO HAMLET.DCL.IND IS TRHAMLET.PUB.DSUSER DSLINE @
GENERIC ENVIRONMENT S@.DCL.IND DSLINE S@;RESET {resets defaults for } GENERIC ENVIRONMENT S@.DCL.IND {generic environment id} Back to Main Index