Reference Guide › Command Reference › GENINCL Command

GENINCL Command

Use the GENINCL command to include or remove a directory profile from a USER or IDENTITY directory entry.

GENINCL userid [profile]

Definitions

userid

Specifies the user directory entry in which a directory profile is to be added or removed.

profile

Is the name of the directory profile to include in the directory entry.

The profile name is required if you are including a directory profile in a user directory entry. It is omitted if you are removing a directory profile from a user directory entry.

Description

The GENINCL command adds an INCLUDE statement to the directory entry of the specified user ID or removes the INCLUDE statement from the specified user directory entry. If you use this command to add a directory profile to a user directory entry, this statement includes the name of the directory profile you specify in the GENINCL command.

A user directory entry contains only one directory profile at a time. If you add a directory profile to a user directory entry and the directory entry already references one, the GENINCL command replaces the INCLUDE statement currently in that user directory entry with the one specified by this GENINCL command. If the user directory entry did not already reference a directory profile, the GENINCL command simply adds an INCLUDE statement for the profile defined by this GENINCL command to that entry.

If you remove a directory profile from a user directory entry, the GENINCL command removes the INCLUDE statement from that entry.

If you try to make a change with the GENINCL command that will result in an invalid directory entry, GENINCL terminates with an error message, and the change is not made.

Examples

• To add a reference to the SALES directory profile in user ID CLIFFC’s directory entry, enter:

  vmdirect genincl cliffc sales
  

• NORMP’s directory entry currently refers to the SALES directory profile. To remove this reference, enter:

  vmdirect genincl normp
  

Note:

• For more information about incorporating statements from a user directory profile directly in the user directory entry, see EDX Command.
• For more information about the INCLUDE statement, see the IBM CP Planning and Administration guide for your release of VM.