 |
» |
|
|
|
Defines the attributes of a remote environment. Syntax |  |
[envID ] DSLINE [[envID=]nodename][;SERVICES][;DSLINE option]... [#Lenvnum ] |
Use |  |
Available In Session? Yes
|
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]}
|
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.
Pattern | Before Rel 4.0 | After 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 EnvIDs | Select all NS EnvIDs and all the ARPA domain
EnvIDs with at least two ".". | @.@.@.@ | None | All 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 ** |
|