HPlogo Using NS 3000/iX Network Services: HP 3000 MPE/iX Computer Systems > Chapter 2 Virtual Terminal

DSLINE Command

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Defines the attributes of a remote environment.

Syntax

                 [envID          ]
DSLINE [[envID=]nodename][;SERVICES][;DSLINE option]...
[#Lenvnum ]

Use

Available          In Session?          Yes
                   In Job?              Yes
                   In Break?            Yes
                   Programmatically?    Yes
Breakable?                              No
Capabilities?                           None

Parameters

envID

An environment ID—that is, a character string representing a specific session on a remote node. For NS names, 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 ARPA domain names, the environment ID has the syntax label[.label[...]. The labels must follow the syntax for ARPANET host names. The envID for ARPA domain names will not be fully qualified. Refer to ARPA Domain Name Syntax in Chapter 1 “Introduction to NS 3000/iX” for more details.

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

When you are using NS names, the nodename is the name assigned to the remote node when it is configured into the NS 3000/iX network. This name may optionally be qualified in the format 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. When you are using ARPA domain names, the nodename has the syntax label[.label[...]. The labels must follow the syntax for ARPANET host names. The envID for ARPA domain names will not be fully qualified. Refer to ARPA Domain Name Syntax in Chapter 1 “Introduction to NS 3000/iX” for more details.

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 “Remote File Access” This option may also be used with the DSCOPY command as explained in

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/iX based system, then you can also specify its prompt by using the SETVAR HPPROMPT command as explained in the MPE/iX 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, 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/iX 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 NS 3000/iX 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

Starting with MPE/iX release 4.0, NS services support ARPA domain node names as well as NS node names. There are some changes in selecting environments using generic EnvIDs. These changes will not affect people who use only NS node names.

PatternBefore Rel 4.0After Rel 4.0
@Selects all EnvIDs with default domain & organization.Select all NS EnvIDs with default domain and organization and all ARPA domain EnvIDs.
@.@Selects all EnvIDs with default organization.Select all NS EnvIDs with default organization and all the ARPA domain EnvIDs with at least one ".".
@.@.@Select all EnvIDsSelect all NS EnvIDs and all the ARPA domain EnvIDs with at least two ".".
@.@.@.@NoneAll the ARPA domain EnvIDs with at least three ".".

Examples

:DSLINE SYS4                                       **NS node name with default
ENVIRONMENT 2: SYS4.DETROIT.MYCO=SYS4.DETROIT.MYCO EnvID, domain & Org**
:DSLINE X1=SYS4                                    **2nd environment referencing
ENVIRONMENT 5: X1.DETROIT.MYCO=SYS4.DETROIT.MYCO same remote node **
:DSLINE ROBERT                                     **DSLINE using ARPA domain
ENVIRONMENT 7: ROBERT=ROBERT.CUP.MYCO.COM node name. Note: EnvID
is not fully qualified **
:DSLINE X2=ROBERT                                  **2nd environment referencing
ENVIRONMENT 9: X2=ROBERT.CUP.MYCO.COM same remote ARPA name**
:DSLINE BOB                                        **using alias to ARPA name
ENVIRONMENT 11: BOB=BOB(ROBERT.CUP.MYCO.COM) "ROBERT". First 50 chars of
ARPA domain name
will be displayed in "()" **
:DSLINE X3=BOB                                     **2nd environment referencing
ENVIRONMENT 13: X3=BOB(ROBERT.CUP.MYCO.COM) same alias name **
:DSLINE SYS3.CHICAGO                               **using NS node with different
ENVIRONMENT 15: SYS3.CHICAGO.MYCO=SYS3.CHICAGO.MYCO domain (CHICAGO)**
:DSLINE X@;PROMPT="TESTENV"                        **change the prompt for all
ENVIRONMENT 5: X1.DETROIT.MYCO=SYS4.DETROIT.MYCO EnvIDs starts with X
ENVIRONMENT 9: X2=ROBERT.CUP.MYCO.COM using genericID X@ **
ENVIRONMENT 13: X3=BOB(ROBERT.CUP.MYCO.COM)
GENERIC ENVIRONMENT X@
:DSLINE                                           **lists default environment **
ENVIRONMENT 15: SYS3.CHICAGO.MYCO=SYS3.CHICAGO.MYCO
:DSLINE @          **lists all the ARPA domain environments (strict pattern match
for ARPA domain EnvIDs) and all the NS environments with
default domain (DETROIT) and organization (MYCO) **
ENVIRONMENT 2: SYS4.DETROIT.MYCO=SYS4.DETROIT.MYCO
ENVIRONMENT 5: X1.DETROIT.MYCO=SYS4.DETROIT.MYCO
ENVIRONMENT 7: ROBERT=ROBERT.CUP.MYCO.COM
ENVIRONMENT 9: X2=ROBERT.CUP.MYCO.COM
ENVIRONMENT 11: BOB=BOB(ROBERT.CUP.MYCO.COM)
ENVIRONMENT 13: X3=BOB(ROBERT.CUP.MYCO.COM
GENERIC ENVIRONMENT X@
:DSLINE @.@.@      **lists all NS environments and ARPA domain environments with
at least two "." **
ENVIRONMENT 2: SYS4.DETROIT.MYCO=SYS4.DETROIT.MYCO
ENVIRONMENT 5: X1.DETROIT.MYCO=SYS4.DETROIT.MYCO
ENVIRONMENT 15: SYS3.CHICAGO.MYCO=SYS3.CHICAGO.MYCO
GENERIC ENVIRONMENT X@:DSLINE X@;SHOW **displays all the EnvIDs that start with X **
ENVIRONMENT #  : 5
ENVIRONMENT ID : X1.DETROIT.MYCO
NODE NAME : SYS4.DETROIT.MYCO
LOGON :
LOGGED ON : NO
PROMPT : TESTENV
ESTABLISHED BY : DSLINE
SERVICES :
OPTIONS :ENVIRONMENT # : 9
ENVIRONMENT ID : X2
NODE NAME : ROBERT.CUP.MYCO.COM
LOGON :
LOGGED ON : NO
PROMPT : TESTENV
ESTABLISHED BY : DSLINE
SERVICES :
OPTIONS :
ENVIRONMENT #  : 13
ENVIRONMENT ID : X3
NODE NAME : BOB
LOGON :
LOGGED ON : NO
PROMPT : TESTENV
ESTABLISHED BY : DSLINE
SERVICES :
OPTIONS :ENVIRONMENT ID : X@
NODE NAME :
LOGON :
LOGGED ON : NO
PROMPT : TESTENV
ESTABLISHED BY : DSLINE
SERVICES :
OPTIONS ::DSLINE @;CLOSE **closes all ARPA domain environments and all NS environments with default domain and organization (DETROIT & MYCO)**ENVIRONMENT 2: SYS4.DETROIT.MYCO=SYS4.DETROIT.MYCO
ENVIRONMENT 5: X1.DETROIT.MYCO=SYS4.DETROIT.MYCO
ENVIRONMENT 7: ROBERT=ROBERT.CUP.MYCO.COM
ENVIRONMENT 9: X2=ROBERT.CUP.MYCO.COM
ENVIRONMENT 11: BOB=BOB(ROBERT.CUP.MYCO.COM)
ENVIRONMENT 13: X3=BOB(ROBERT.CUP.MYCO.COM):DSLINE BOB.TEST.TEST=BOB **using user defined EnvID with alias ARPA domain **ENVIRONMENT 2: BOB.TEST.TEST=BOB(ROBERT.CUP.MYCO.COM):DSLINE @.@.@ **lists all the NS environments and
ARPA domain EnvIDs with at least two "."s **ENVIRONMENT 2: BOB.TEST.TEST=BOB(ROBERT.CUP.MYCO.COM)
ENVIRONMENT 15: SYS3.CHICAGO.MYCO=SYS3.CHICAGO.MYCO
GENERIC ENVIRONMENT X@:DSLINE @.@.@;CLOSE **closes all the NS envs and ARPA
domain EnvIDs with at least two "."s. **ENVIRONMENT 2: BOB.TEST.TEST=BOB(ROBERT.CUP.MYCO.COM)
ENVIRONMENT 15: SYS3.CHICAGO.MYCO=SYS3.CHICAGO.MYCODSLINE X@;RESET **resets defaults for generic
GENERIC ENVIRONMENT X@ environment ID **
Feedback to webmaster