Restore Object iWeb (RSTOBJIWEB)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Restore Object iWeb (RSTOBJIWEB) command restore objects, from a save file, as the system command RSTOBJ and RST plus all iWeb related objects, related customizations and related definitions.

Nota: This command has to be used in correlation with the command SAVOBJIWEB.

Top

Parameters

Keyword Description Choices Notes
OBJ Object Single values: *ALL
Other values (up to 300 repetitions): Generic name, name
Optional, Positional 1
SAVLIB Save library Values (up to 300 repetitions): Name Optional, Positional 2
SAVF Save file Qualified object name Optional, Positional 3
Qualifier 1: Save file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PGM Programs (WebEnabled or not) *YES, *NO Optional, Positional 4
DSPF Display files Element list Optional, Positional 5
Element 1: *FILE *YES, *NO
Element 2: iWeb XML definition *YES, *NO
MENU Menus Element list Optional, Positional 6
Element 1: *MENU *FILE *MSGF *YES, *NO
Element 2: iWeb XML definition *YES, *NO
IWEBMASTER iWebMaster customization *YES, *NO Optional, Positional 7
RUNTIME Synchronise runtime Element list Optional, Positional 8
Element 1: *RUNTIME *YES, *NO
Element 2: *APPLET *YES, *NO
RSTLIB Restore to library Name, *SAVLIB Optional, Positional 9
IFSOBJ IFS Objects (img, doc, etc.) Single values: *NONE
Other values (up to 100 repetitions): Element list
Optional, Positional 10
Element 1: Name Path name, *
Element 2: Include or omit *INCLUDE, *OMIT
Element 3: New object name Path name, *SAME
SUBTREE IFS Subtree pattern *ALL, *DIR, *NONE, *OBJ, *STG Optional, Positional 11
RSTASPDEV Restore to ASP device Name, *SAVASPDEV Optional, Positional 12
RSTASP Restore to ASP number Character value, *SAVASP Optional, Positional 13
OUTPUT Output information *, *NONE, *PRINT, *OUTFILE Optional, Positional 14
OUTFILE Output file Qualified object name Optional, Positional 15
Qualifier 1: Output file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTMBR Output member option Element list Optional, Positional 16
Element 1: Member to receive output Name, *FIRST
Element 2: Operation to perform on member *REPLACE, *ADD
Top
Top
Top
Top

Programs (WebEnabled or not) (PGM)

Specifies if you want to restore object of type *PGM

*YES
All object of type *PGM (original and iWeb converted) will be restored.
*NO
Object of type *PGM (original and iWeb converted) will not be restored.
Top

Display files (DSPF)

Specifies if you want to restore object of type *FILE with attribute DSPF and if you want to restore the iWeb conversion (XML definition) of type *FILE with attribute DSPF

Nota: You can either restore only object DSPF (type *FILE) and not the iWeb version or only the iWeb version and not DSPF or restore all.

Element 1: *FILE

*YES
All object of type *FILE with attribute DSPF will be restored.
*NO
Object of type *FILE with attribute DSPF will not be restored.

Element 2: iWeb XML definition

*YES
All iWeb conversion (XML definition) of display file will be restored.
*NO
iWeb conversion (XML definition) of display file will not be restored.
Top

Menus (MENU)

Specifies if you want to restore object of type *MENU and if you want to restore the iWeb conversion (XML definition) of type *MENU

Nota: You can either restore only object *MENU and not the iWeb version or only the iWeb version and not *MENU or restore all.

Element 1: *MENU

*YES
All object of type *MENU will be restored.
*NO
Object of type *MENU will not be restored.

Element 2: iWeb XML definition

*YES
All iWeb conversion (XML definition) of Menu (coming from object type *MENU or not) will be restored.
*NO
iWeb conversion (XML definition) of Menu (coming from object type *MENU or not) will not be restored.
Top

iWebMaster customization (IWEBMASTER)

Specifies if you want to restore iWebMaster customization.

*YES
iWebMaster customization will be restored.
*NO
iWebMaster customization will not be restored.
Top

Synchronise runtime (RUNTIME)

Specifies if you want to restore the server RUNTIME and the browser client APPLET to synchronise the all RUNTIME with the saved version.

Nota: You can either restore only the server runtime and not the applet or only the applet and not the server runtime or restore all.

Element 1: *RUNTIME

*YES
The server runtime will be restored.
*NO
The server runtime will not be restored.

Element 2: *APPLET

*YES
The applet (browser client) will be restored.
*NO
The applet (browser client) will not be restored.
Top
Top

Oggetti (OBJ)

Specifica il nome del percorso dell'oggetto da ripristinare. E' possibile specificare un modello per questo nome di percorso. Può essere specificato un massimo di 300 modelli di nomi percorso.

Per ulteriori informazioni riguardanti la specifica dei nomi percorso, consultare "Regole di denominazione oggetti" in "Concetti e riferimenti CL" in L'argomento CL concepts and reference nell'iSeries Information Center all'indirizzo http://www.ibm.com/eserver/iseries/infocenter.

Ulteriori informazioni sui modelli di nome dell'oggetto sono in Info sull'IFS (Integrated file system) nell'iSeries Information Center all'indirizzo http://www.ibm.com/eserver/iseries/infocenter.

Elemento 1: Nome

Specifica gli oggetti salvati sul supporto magnetico. Le abbreviazioni dell'indirizzario (ad esempio, l'indirizzario corrente) vengono estese con i loro valori correnti e non quelli avuti al momento dell'operazione di salvataggio.

'*'
Vengono ripristinati tutti gli oggetti dell'indirizzario corrente.
nome-percorso
Specificare un nome di percorso dell'oggetto oppure un modello che può corrispondere a molti nomi. Se viene specificato *SAME per il terzo elemento di questo parametro, è necessario che ciascun componente nel nome percorso esista, ad eccezione dell'ultimo. Il nome dell'oggetto nell'ultimo componente è ripristinato come nuovo se questo non esiste.

Elemento 2: Includere o omettere

Specifica se i nomi che corrispondono al modello devono essere inclusi o omessi dall'operazione. E' da notare che nel determinare se un nome corrisponde ad un modello, i modelli di nome relativi sono sempre trattati come relativi all'indirizzario di lavoro corrente.

Nota: Il parametro SUBTREE determina se gli alberi secondari sono inclusi o omessi.

*INCLUDE
Devono essere ripristinati gli oggetti che corrispondono al modello di nome oggetto, eccetto il caso in cui venga sostituito da una specifica *OMIT.
*OMIT
Non devono essere ripristinati gli oggetti che corrispondono al modello di nome oggetto. Questo sostituisce una specifica *INCLUDE e deve essere utilizzato per omettere una sottoserie di un modello selezionato precedentemente.

Elemento 3: Nuovo nome oggetto

Specifica il nuovo nome percorso dell'oggetto.

*SAME
Gli oggetti devono essere ripristinati con gli stessi nomi che avevano quando sono stati salvati.
nome-percorso
Specificare il nome di percorso con il quale si ripristina l'oggetto. Se viene specificato un modello nel primo elemento, il nuovo nome di percorso deve essere l'indirizzario nel quale si ripristinano tutti gli oggetti che corrispondono al modello. Se un nome dell'oggetto è specificato nell'elemento 1, ogni componente nel nuovo nome di percorso deve esistere ad eccezione dell'ultimo componente. Se l'oggetto descritto nell'ultimo componente non esiste, esso deve essere ripristinato come nuovo.
Top

Albero secondario indirizzari (SUBTREE)

Specifica se vengono inclusi nell'operazione di ripristino gli alberi secondari dell'indirizzario.

*ALL
Viene elaborato l'albero secondario intero di ogni indirizzario che corrisponde al modello di nome oggetto. L'albero secondario include tutti i sottoindirizzari e gli oggetti che sono all'interno di quei sottoindirizzari.
*DIR
Vengono elaborati gli oggetti nel primo livello di ogni indirizzario che corrisponde al modello del nome oggetto. Vengono inclusi i sottoindirizzari di tutti gli indirizzari corrispondenti, ma non gli oggetti dei sottoindirizzari.
*NONE
Non vengono inclusi sottoalberi nell'operazione di ripristino. Se un indirizzario corrisponde al modello del nome oggetto specificato, vengono inclusi gli oggetti dell'indirizzario. Se l'indirizzario ha sottoindirizzari, non vengono inclusi né sottoindirizzari né gli oggetti dei sottoindirizzari.
*OBJ
Vengono elaborati solo gli oggetti che corrispondono al modello di nome oggetto. Se il modello nome oggetto specifica un indirizzario, gli oggetti nell'indirizzario non vengono inclusi.
*STG
Gli oggetti che corrispondono al modello del nome oggetto vengono elaborati insieme alla memoria degli oggetti relativi. Gli oggetti possono essere ripristinati soltanto utilizzando questo valore se sono stati salvati con SUBTREE(*STG).
Top
Top
Top
Top
Top
Top

Examples for RSTOBJIWEB

Example 1: Simple Command Example

RSTOBJIWEB  KWD1(PARMVAL1)

This command <...>

Example 2: More Complex Command Example

RSTOBJIWEB   KWD1(PARMVAL1)  KWD2(PARMVAL2)
             KWD3(PARMVAL3)

This command <...>

Top

Error messages

Unknown
Top