RMVTCPPTP (Remove Point-to-Point TCP/IP Profile)

RMVTCPPTP Command syntax diagram

 

Purpose

The Remove Point-to-Point TCP/IP Profile (RMVTCPPTP) command is used to remove a point-to-point connection profile. There could be an output queue (*OUTQ) object associated with the profile (QUSRSYS/profile-name) and this *OUTQ would also be removed.

 

Restrictions

You must have *IOSYSCFG special authority to use this command.

Parameters

CFGPRF

Specifies the name of the point-to-point configuration profile to remove. Optionally, all associated communications objects associated with this profile can also be deleted.

configuration-profile-name: Specify the name of a valid, inactive point-to-point configuration profile to delete.

DLTCMNCFG

Specifies whether you want to delete all communications configuration objects associated with this point-to-point profile. This would include the line, controller and device descriptions defined for use with this profile. Optionally, for some profile types this could also include any network interface descriptions and connection lists associated with the line description being deleted.

*NO: Do not delete any of the communications configuration currently associated with this point-to-point profile.

*YES: Delete the communications configuration associated with this point-to-point profile. If the communications configuration object to be deleted is found to have other point-to-point profiles or line descriptions using it or is not in a 'VARIED OFF' state, it will not be deleted. If a communications object is not deleted a message will be sent.

Examples for RMVTCPPTP

Example 1: Delete a Point-to-Point Profile

RMVTCPPTP CFGPRF(SLIPPROF)

This command will remove the point-to-point profile named 'SLIPPROF'. Any communications configuration objects associated with this profile will not be deleted.

Example 2: Delete Profile and Related Communications Configuration Objects

RMVTCPPTP CFGPRF(ANSPROF) DLTCMNCFG(*YES)

This command will remove the point-to-point profile named 'ANSPROF' and all communications configuration objects associated with the profile. Additionally, if any of the configuration objects are found to be shared with other point-to-point profiles, such as a line description, then the object will NOT be deleted. If an object is not deleted, a diagnostic message will be sent indicating which object was not deleted and why.

Error messages for RMVTCPPTP

*ESCAPE Messages

TCP83E0

Point-to-point profile &1 not removed.