ADDRMTDFN (Add Remote Definition)

ADDRMTDFN Command syntax diagram

 

Purpose

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: You must have *ALLOBJ authority to use this command.

 

Required Parameters

SYSTEM

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

*ANY: A default definition is added to be used for all remote systems whose attributes are not yet defined.

Element 1: System Name

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

Element 2: System Group

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

 

Optional Parameters

TEXT

Specifies the text that briefly describes the remote system definition. More information is in Commonly used parameters.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

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), specify *EMN for this parameter. If you are unsure, specify *FFTDCA for this parameter.

*FFTDCA: Final-form text documents are accepted. The remote system does not accept enterprise meeting notice documents.

*EMN: Enterprise meeting notice documents are accepted.

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.

*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.

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.

*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).

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.

*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.

RMTLOCNAME

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

*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.

LCLLOCNAME

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

*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.

RMTNETID

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

*LOC: The remote network identifier (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 identifier (ID) is used.

remote-network-ID: Specify the remote network ID.

MODE

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

*NETATR: The mode name specified in the network attributes is used.

mode-name: Specify the name of the mode.

Examples for ADDRMTDFN

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.

Error messages for ADDRMTDFN

*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.