Unsubmit a changelist, making it a shelved set of changes.

You may not issue this command directly to an edge server; you can issue it directly to a commit server.

p4 [g-opts] unsubmit [-n] [-r remote] filespec[revRange] ...

The p4 unsubmit command takes one or more submitted changelists and undoes the submission(s), leaving the changelist as a shelved change with the same content. The changelist can then be unshelved and further updated prior to resubmitting it.

The changelist must have been submitted by the same user and workspace which are used in the p4 unsubmit command. The files in the changelist must be the head revisions of those files in the server. The files must not have been integrated into any other files in the server. The files must not be open by any pending or shelved changelists. The files must not have been archived or purged. The files must not have associated attributes.

If the command specifies multiple files and/or multiple revisions, all the changelists which affected the specified revisions of the specified files are unsubmitted; each such change becomes its own separate shelf. Fix records linked to the changelist are not modified.

After unsubmitting a change which has associated jobs, you should review the job and fix status for accuracy. The shelved changelists that are created do not fire any triggers of type shelve-submit or shelve-commit.

After all the specified changelists have been unsubmitted, the p4 unsubmit command syncs the workspace to the head revision.