Macro Language Reference > PIs > Text > <?psequp>
  
<?psequp>
Description
This command will queue up a page sequence for use on the next page. It will force a page break only if content has already been output in the current frame, which allows for multiple <?pseqstart> commands to be issued in succession without creating multiple pages, for example switching into a page sequence for a section then switching to the layout for the first chapter. In this situation, as long as no content was formatted between the two page sequence commands, the section sequence will be ignored and the chapter sequence will be used instead.
<?pseqstart> and <?psequp> have the same basic use — the only difference is that <?pseqstart> will replace the current page sequence and start the new one, whilst <?psequp> will save the state of the current page sequence before starting it. The saved page sequence will then be restored once the new sequence has finished.
Syntax
<?psequp id:n ',' pseq:s (',' initial:n ',' force:n ',' start:n (',' numformat:n (',' sep: ',' sepwidth:n )? )? )?>
id
An arbitrary id number to allow this instance of the page sequence to be identified easily when accessing the getvars during formatting.
pseq
The name of the Page Sequence control to process.
Must be declared in double quotes.
initial
The initial page number to use for this instance of the page sequence:
0
Auto : if this is the first page sequence use 1, otherwise use one greater than the last page number of the previous page sequence
-1
Auto-Odd : as with Auto (above), but use the next highest odd number
-2
Auto-Even: As with Auto (above), but use the next highest even number
>0
Set the initial page number to this value
force
Whether this page sequence should contain an odd or even number of pages:
0
No force: do not force any pages
1
Even: force an even number of pages in this page sequence
2
Odd: force an odd number of pages in this page sequence
3
End on Even: force the last page of the page sequence to be an even page
4
End on Odd: force the last page of the page sequence to be an odd page
start
Whether this page sequence should start on an odd or even page:
0
No force: do no force any pages
1
Even: force the new page sequence to start on an even page
2
Odd: force the new page sequence to start on an odd page
numformat
The number format to use when creating the text version of the Page Sequence page number
Must be declared in double quotes.
sep
The separator character to use for in the number format
Must be declared in single quotes.
sepwidth
The number of characters to output between each separator
Related Links