Add Remote Definition (ADDRMTDFN)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Add Remote Definition (ADDRMTDFN) command is used to define the attributes of a remote system and add them to the remote system definition table.

Restriction: The user must have *ALLOBJ authority.

Top

Parameters

Keyword Description Choices Notes
SYSTEM System name Element list Required, Positional 1
Element 1: System name Character value, *ANY
Element 2: System group Character value
TEXT Text Character value, *BLANK Optional, Positional 2
MTGNTCDOC Meeting notice document type *FFTDCA, *EMN Optional
CALDTASTM Calendar data stream Single values: *NONE
Other values (up to 5 repetitions): Communications name, *OV400
Optional
RMTCALPWD Calendar password Simple name, *NONE Optional
RMTUSRAUT Remote user authority *PRIVATE, *PUBLIC, *MINIMUM, *EXCLUDE Optional
RMTLOCNAME Remote location Communications name, *SYSTEM Optional
LCLLOCNAME Local location Communications name, *LOC, *NETATR Optional
RMTNETID Remote network identifier Communications name, *LOC, *NETATR, *NONE Optional
MODE Mode Communications name, *NETATR Optional
Top

System name (SYSTEM)

Specifies the system name and system group of the remote system being defined.

This is a required parameter.

The possible values are:

*ANY
Adds a default definition for all remote systems not covered by the other entries.

The possible System Name value is:

system-name
Specify the name of the remote system being defined.

The possible System Group value is:

system-group
Specify the group name of the remote system being defined. The system group name is blank if this value is not specified.
Top

Text (TEXT)

Specifies text that describes the remote system definition.

The possible values are:

*BLANK
Text is not specified.
'description'
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Meeting notice document type (MTGNTCDOC)

Specifies the type of meeting notice documents accepted by the remote system. If the system can accept Enterprise Meeting Notice Architecture documents (post-V2R1M1 AS/400 systems), you should specify *EMN for this parameter. If you are unsure, specify *FFTDCA for this parameter.

The possible values are:

*FFTDCA
The remote system does not accept enterprise meeting notice documents, but does accept final-form text documents.
*EMN
The remote system accepts enterprise meeting notice documents.
Top

Calendar data stream (CALDTASTM)

Specifies the type of calendar data stream that the local system uses when sending a request for calendar information to this remote system. Each type of calendar data stream represents a format in which remote calendar requests are made from the local system to this remote system.

The possible values are:

*OV400
The OfficeVision calendar data stream is used.
calendar-data-stream
Specify the name of the calendar data stream that is used. The name of the data stream can be a maximum of 10 characters.

Single Value:

*NONE
No calendar data stream is used.
Top

Calendar password (RMTCALPWD)

Specifies the password that is associated with user profile QRMTCAL on the remote system. This user profile is used to sign on to the remote system when processing a request for calendar information.

The possible values are:

*NONE
No password is used for user profile QRMTCAL.
calendar-password
Specify the password that is defined for QRMTCAL. If the password is numeric, it must begin with a Q (for example, specify Q1234 when 1234 is the password).
Top

Remote user authority (RMTUSRAUT)

Specifies the object authority for calendar objects on the local system to be used for incoming requests for calendar information from remote system users. This parameter is used by OfficeVision calendar processing to determine authority to calendars.

The possible values are:

*PRIVATE
Private authority is used for requests from the remote system. If private authority does not exist, public authority is used.
*PUBLIC
Public authority is used for requests from the remote system.
*MINIMUM
The lesser of the private or the public authority is used for requests from the remote system.
*EXCLUDE
Local system objects cannot be accessed by users on the remote system.
Top

Remote location (RMTLOCNAME)

Specifies the remote location name of the remote system being added.

The possible values are:

*SYSTEM
The name specified on the SYSTEM parameter is used for the remote location name.
remote-location-name
Specify the full name of a remote location.
Top

Local location (LCLLOCNAME)

Specifies the location name that identifies the local system to the remote system being added.

The possible values are:

*LOC
The local location name associated with the remote location is used.
*NETATR
The LCLLOCNAME value specified in the system network attributes is used.
local-location-name
Specify the name of the local location.
Top

Remote network identifier (RMTNETID)

Specifies the remote network identifier (ID) for the remote system being added.

The possible values are:

*LOC
The remote network ID associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.
*NETATR
The RMTNETID value specified in the system network attributes is used.
*NONE
No remote network ID is used.
remote-network-ID
Specify the remote network ID.
Top

Mode (MODE)

Specifies the name of the mode that defines the device sessions used to request data from the remote system.

The possible values are:

*NETATR
The mode name specified in the network attributes is used.
mode-name
Specify the name of the mode.
Top

Examples

Example 1: Adding a Specific Remote Definition

ADDRMTDFN   SYSTEM(ABCXYZ)  TEXT('System XYZ')  MTGNTCDOC(*EMN)

This command adds a definition for a remote system ABCXYZ and allows the system to accept enterprise meeting notice documents.

Example 2: Allowing Final Form Text Documents

ADDRMTDFN   SYSTEM(*ANY)  MTGNTCDOC(*FFTDCA)

This command allows all remote systems that do not have specific remote definitions to accept final form text meeting notices.

Example 3: Adding a Remote Definition with Password

ADDRMTDFN   SYSTEM(DALLAS1)  TEXT('SYSTEM1')  MTGNTCDOC(*EMN)
            RMTCALPWD(CALPWD)  LCLLOCNAME(*NETATR)

This command adds a definition for the remote system DALLAS1, which accepts enterprise meeting notice documents. The password to sign on the system is CALPWD. The remote system will identify the local system by the name specified in the system network attributes.

Top

Error messages

*ESCAPE Messages

CPF6DCA
SYSTEM parameter cannot be local system.
CPF6DCB
Remote definition for system &1 &2 already exists.
CPF9899
Error occurred during processing of command.
Top