MOVE Function—Move an ACID

Command Functions › MOVE Function—Move an ACID

MOVE Function—Move an ACID

Use the MOVE function to:

Move an ACID from one department, division or zone to another
Change a user, ZCA, DCA and/or VCA into an SCA
Promote or demote the type of ACID

Administrators must have authority, via ADMIN ‑ ACID(MAINTAIN|ALL), to move ACIDs within their scope.

This command function has the following format:

TSS MOVE(acid) DEPARTMENT(acid)|DIVISION(acid)|ZONE(acid)
               TYPE(acid)

acid: Specifies the ACID being moved.
DEPARTMENT(acid)|DIVISION(acid)|ZONE(acid): Specifies the department, division or zone ACID of the destination. Not entering a department, division or zone makes the ACID (user, DCA, VCA, ZCA, LSCA) an SCA.
TYPE(acid): Specifies the ACID type you are moving to.

Example: MOVE function

This example moves a user (ACT4T) from the Accounts Receivable Department to the Accounts Payable Department (DACTPAY):

TSS MOVE(ACT4T) DEPARTMENT(DACTPAY)

Effects of MOVE if the TYPE Keyword is Omitted

The movement of an ACID from one organization to another may change the ACID type of the ACID being moved. The following table shows how each type of ACID is changed when moved into another department, division, or zone.

ACID Type	When moved into a DEPARTMENT	When moved into a DIVISION	When moved into a ZONE	When moved with no destination:
USER	Remains User	Becomes VCA	Becomes ZCA	Becomes SCA
PROFILE	Remains Profile	N/A	N/A	N/A
DCA	Remains DCA	Becomes VCA	Becomes ZCA	Becomes SCA
VCA	Becomes DCA	Remains VCA	Becomes ZCA	Becomes SCA
ZCA	Becomes DCA	Becomes VCA	Remains ZCA	Becomes SCA
LSCA*	Becomes DCA	Becomes VCA	Becomes ZCA	Becomes SCA
SCA	Becomes DCA	Becomes VCA	Becomes ZCA	N/A
DEPARTMENT	N/A	Connected ACIDs and resources are moved with the department to a new division.	N/A	Remains DEPARTMENT with no division
DIVISION	N/A	N/A	Connected ACIDs and resources are moved with the division to a new zone	Remains DIVISION with no zone

LSCA can only be moved once his scope of authority has been removed. For example:

TSS DEADMIN(LSCA01) SCOPE(ZONE01,LSCA02)

The following considerations apply when performing a MOVE:

Only the MSCA can move a USER to an SCA
Only the MSCA, SCA or ZCA (within scope) can move a DIVISION or VCA
Only the MSCA, SCA, or VCA (within scope) can move a DEPARTMENT or DCA
Only the MSCA, SCA, or VCA (within scope) can move a USER or PROFILE
Only the MSCA can move an LSCA

Effects of MOVE Using the TYPE Keyword

With the TYPE keyword, an administrator can move an ACID from its original type to a new targeted type. A DEPARTMENT or DIVISION will only be specified if the new targeted ACID type requires it. See the table below for details.

TYPE Specification	Keyword Required
SCA	N/A
LSCA	N/A
ZCA	ZONE
VCA	DIVISION
DCA	DEPARTMENT
USER	DEPARTMENT

Examples: MOVE with the TYPE keyword

This example moves a DCA (DCA01) into a new financial department (FINDEPT) and demote this DCA to a TYPE(USER):

TSS MOVE(DCA01) DEPARTMENT(FINDEPT)
                TYPE(USER)

This example leaves a TYPE(USER) in the same department but promotes it to a DCA:

TSS MOVE(USER01)TYPE(DCA)