HP 3000 Manuals HP 3000 Manuals
DSLINE Command Defines the attributes of a remote environment. Syntax _________________________________________________________________________ | | | [envID ] | | DSLINE [ [envID=]nodename][;SERVICES][;DSLINEoption]...| | [#Lenvnum ] | _________________________________________________________________________ UseParameters envID An environment ID--that is, a character string representing a specific session on a remote node. The environment ID itself may optionally be qualified as follows: envname[.domain[ .organization]]. Each portion of the string may have a maximum of 16 alphanumeric characters (including underscores and hyphens), of which the first must be alphabetic. The default domain and organization names are those specified for your local node when it is configured. For some dslineoptions, an envID can be a generic environment ID representing a set of environments. A generic environment ID can include the MPE wild card 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 will be 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: the specified nodename (which then becomes an environment ID) or, if nodename is omitted as well, the environment specified by the last DSLINE or REMOTE command. nodename Nodename is the name assigned to the remote node when it is configured into the NS3000/XL network. This name may optionally be qualified in the form node[.domain[ .organization]]. The default domain and organization are those of the local node. Each portion of this string may have a maximum of 16 alphanumeric characters (including underscores and hyphens), of which the first must be alphabetic. 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. envnum An environment number representing a specific session on a remote node. This is the number of the environment in the message printed out following a prior DSLINE command. SERVICES Lists the status of the services on the node (local or remote) indicated by the environment ID. DSLINEoption One of the options described in the following paragraphs. QUIET Specifies that no logon message be displayed when you log on to the remote environment, no logoff message be displayed when you log off, and no environment messages be displayed when a DSLINE command is executed. COMP or NOCOMP (default is NOCOMP) Enables or disables data compression to the remote environment. The compression only affects NFT and RFA transmissions. If data compression is in effect, sequences of repeated characters (such as blanks) are translated into more compact form before transfer. They are decompressed after arrival at their destination. For a discussion of RFA compression, refer to "RFA Compression" in chapter 3. This option may also be used with the DSCOPY command as explained in Chapter 5. 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. PROMPT=promptstring Specifies a prompt for the remote environment. This can be used to distinguish one remote environment from another. The prompt string can be 1 to 8 characters long, optionally surrounded by quotation marks. All characters are allowed, but if the string contains a semicolon 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 the whole environment name if shorter) terminated by #. If PROMPT= is specified without a prompt string, the prompt becomes the normal local prompt from the remote operating system for instance, a colon (:). If the remote system is an MPE XL based system, then you can also specify its prompt by using the SETVAR HPPROMPT command as explained in the MPE XL Commands Reference Manual. If you specify that the prompt be anything other than a colon, then that specification will override any prompt created by the DSLINE option described here. The SETVAR HPPROMPT will be temporarily overridden if you leave the remote session and then return to it--after a REMOTE command, the prompt will remind you which system you are on--after you type a carriage return, the prompt will return to the one you set with SETVAR HPPROMPT. For an example, refer to the discussion under the REMOTE command. LOGON=logonsequence Specifies a logon sequence for the remote system, which can be used by NFT and RPM in order to create a temporary session on the remote node. (See the NFT and RPM chapters of this manual for a discussion of when this logon will take effect.) The logon sequence must include all necessary passwords. It must be delimited by quotation marks if it contains characters which might cause it to be parsed incorrectly by the remote system. TRACE= traceoptions 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 traceoptions parameters are: {[ [ON][,service][,file][,recs][,maxdata],TRANS]} {[ [OFF][,service] ]} The service parameter can be: VT, RFA, DRDBA, NFT, RPM, or ALL. Through these choices, you can activate or deactivate tracing for one or all Network Services. The other parameters have the following meanings: * file: The name of a new or existing MPE XL 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. * recs: The number of records allotted to a new trace file. Default: 1024. * maxdata: 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 port messages. For further information on tracing, see the NS3000/XL Operations and Maintenance Reference Manual.
NOTE The following dslineoptions are obsolete and are ignored in all cases (if used, a warning message is printed): EXCLUSIVE, FROMADDR=, FROMADR=, LINEBUF=, LOCID=, NOQUEUE, OPEN, PHNUM=, QUEUE, REMID, SELECT=, TOADDR=, and TOADR=.
Description The DSLINE command defines the attributes of a remote environment. These attributes are used when you log on to the remote node via a REMOTE HELLO command or when NFT or RPM creates a temporary remote session with the logon sequence specified in the DSLINE LOGON option. In order to establish a remote environment, you must either equate an environment ID with the actual node name, or else 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. 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 you omit the nodename, envID, and envnum, 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 the examples that follow.) After a DSLINE command has been executed, a message is printed that identifies all the affected environments. This message includes, for each environment, the environment number assigned (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, 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. The reason for this is that no new environment (with new default attributes) is being defined. Examples In the following examples, the input is typed at the MPE XL prompt, and user input is underlined for clarity. DSLINE ATHENA ENVIRONMENT 1: ATHENA.DCL.IND **default domain (DCL) and organization (IND)** DSLINE A2=ATHENA;PROMPT=A2 ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND **2nd environment referencing same node** DSLINE APOLLO;TRACE=ON,ALL ENVIRONMENT 3:APOLLO.DCL.IND **traces all NS activity to remote environment** DSLINE A@;LOGON=MGR.NSUSER ENVIRONMENT 1: ATHENA.DCL.IND ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND GENERIC ENVIRONMENT: A @.DCL.IND **sets logon for multiple environments** DSLINE A2;SHOW **environment information** ENVIRONMENT # : 2 ENVIRONMENT ID : A2.DCL.IND NODE NAME : ATHENA.DCL.IND LOGON : MGR.NSUSER LOGGED ON : NO PROMPT : A2 ESTABLISHED BY : DSLINE SERVICES : OPTIONS : DSLINE ACCTNG; SERVICES **returns a list of services from node ACCTNG** SERVICE TYPE STARTED SERVER DESCRIPTION RPM REMOTE YES DSSERVER INCOMING RPM RPML LOCAL YES DSSERVER OUTGOING RPM RFA REMOTE YES DSSERVER INCOMING RFA RFA LLOCAL YES DSSERVER OUTGOING RFA DSLINE @ **lists all environments within default domain and organization** ENVIRONMENT 1: ATHENA.DCL.IND ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND ENVIRONMENT 3: APOLLO.DCL.IND GENERIC ENVIRONMENT A@.DCL.IND **last environment becomes default** DSLINE **returns default environment** ENVIRONMENT 3: APOLLO.DCL.IND DSLINE @;CLOSE **deletes environment IDs and numbers** ENVIRONMENT 1: ATHENA.DCL.IND ENVIRONMENT 2: A2.DCL.IND=ATHENA.DCL.IND ENVIRONMENT 3: APOLLO.DCL.IND DSLINE @ NO ENVIRONMENTS GENERIC ENVIRONMENT A@.DCL.IND DSLINE A@;RESET **resets defaults for generic environment ID**
![[]](../../pic3k/M010442/CH2USE3c50.gif)