Verbs and Built-in Functions › &AOMMIGID

&AOMMIGID

&AOMMIGID parses a system command string to determine whether a migration ID is required.

This built-in function has the following format:

&result = &AOMMIGID command-string

The return value is NO (meaning no migration ID required) or YES (meaning a migration ID is required). This value is used directly as the value for the MIGID operand on a SYSCMD command.

If one of the following is true, then NO is always returned:

• The current console type (as set by the AOMCTYPE SYSPARM) does not support migration IDs (that is, the type is NOT EXTMCS).
• No consoles are currently acquired.

If no command text is supplied, or if it is too long (more than 126 characters), then an error is raised. The NCL procedure terminates.

Example: &AOMMIGID

&CMD=STR D J,L

&MIG=&AOMMIGID &CMD