Change Remote Definition (CHGRMTDFN)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Remote Definition (CHGRMTDFN) command changes the attributes of a remote system in the remote definition table.
Restriction: You must have *ALLOBJ authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSTEM | System name | Element list | Required, Key, Positional 1 |
| Element 1: System name | Character value, *ANY | ||
| Element 2: System group | Character value | ||
| TEXT | Text | Character value, *SAME, *BLANK | Optional, Positional 2 |
| MTGNTCDOC | Meeting notice document type | *SAME, *FFTDCA, *EMN | Optional |
| CALDTASTM | Calendar data stream | Single values: *SAME, *NONE Other values (up to 5 repetitions): Communications name, *OV400 |
Optional |
| RMTCALPWD | Calendar password | Simple name, *SAME, *NONE | Optional |
| RMTUSRAUT | Remote user authority | *SAME, *PRIVATE, *PUBLIC, *MINIMUM, *EXCLUDE | Optional |
| RMTLOCNAME | Remote location | Communications name, *SAME, *SYSTEM | Optional |
| LCLLOCNAME | Local location | Communications name, *SAME, *LOC, *NETATR | Optional |
| RMTNETID | Remote network identifier | Communications name, *SAME, *LOC, *NETATR, *NONE | Optional |
| MODE | Mode | Communications name, *SAME, *NETATR | Optional |
| Top |
System name (SYSTEM)
Specifies the system name and system group of the remote system being changed.
This is a required parameter.
The possible values are:
- *ANY
- The default definition, which is used by remote systems for whom attributes are not yet defined, is changed.
The possible system name value is:
- system-name
- Specify the name of the remote system being changed.
The possible system group value is:
- system-group
- Specify the group name of the remote system being changed. The system group name is blank if this value is not specified.
| Top |
Text (TEXT)
Specifies text that briefly describes the remote system definition. More information on this parameter is in Appendix A of the CL Reference.
The possible values are:
- *SAME
- The value does not change.
- *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.
The possible values are:
- *SAME
- The value does not change.
- *FFTDCA
- Final-form text documents are accepted. The remote system does not accept enterprise meeting notice architecture documents.
- *EMN
- Enterprise meeting notice architecture documents are accepted (post-V2R1M1 AS/400 systems).
| 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 single values are:
- *SAME
- The value does not change.
- *NONE
- No calendar data stream is used.
The possible multiple 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.
| 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:
- *SAME
- The value does not change.
- *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:
- *SAME
- The value does not change.
- *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 updated.
The possible values are:
- *SAME
- The value does not change.
- *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.
The possible values are:
- *SAME
- The value does not change.
- *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) of the remote system being updated.
The possible values are:
- *SAME
- The value does not change.
- *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:
- *SAME
- The value does not change.
- *NETATR
- The mode name specified in the network attributes is used.
- mode-name
- Specify the name of the mode.
| Top |
Examples
Example 1: Changing the Description of a Remote Definition
CHGFRMTDFN SYSTEM(ABCXYZ) TEXT('LONDON REMOTE XYZ')
This command changes the description of the remote system ABCXYZ to LONDON REMOTE XYZ.
Example 2: Changing the Calendar Data Stream for Undefined Systems
CHGRMTDFN SYSTEM(*ANY) CALDTASTM(*OV400)
This command changes the default definition for remote systems that do not have specific remote definitions. These systems are defined to support the OfficeVision data stream for remote calendar requests.
| Top |
Error messages
*ESCAPE Messages
- CPF6DCA
- SYSTEM parameter cannot be local system.
- CPF6DCC
- Remote definition for system &1 &2 not found.
- CPF9899
- Error occurred during processing of command.
| Top |