Impostazione delle preferenze del programma di analisi HLASM

Modifica online

Utilizzare la pagina delle preferenze Programma di analisi HLASM per specificare opzioni per la modifica dei file High Level Assembler nell'editor LPEX z Systems.

Procedura

Per impostare le preferenze del parser HLASM:

Nella finestra Preferenze, vai su LPEX Editor > z Systems LPEX Editor > HLASM Parser.
Nella sezione Comandi LPEX iniziali :
1. Immettere il comando dell'editor che si desidera eseguire ogni volta che il parser HLASM apre un file. Ad esempio, se si definisce un file di istruzioni di colore personalizzato che si desidera venga utilizzato da tutti i file, è possibile aggiungere un comando denominato setCustomColoring on all'elenco di comandi dell'editor che vengono eseguiti ogni volta che il programma di analisi apre un file.
  I comandi vengono eseguiti quando un file viene aperto nel parser HLASM.
2. Fare clic su Aggiungi per aggiungere il comando all'elenco di comandi dell'editor.
3. Facoltativo. Per modificare un comando nell'elenco di comandi dell'editor, effettuare quanto segue:
  1. Dall'elenco dei comandi dell'Editor, selezionare il comando che si desidera modificare e fare clic su Modifica comando per aprire la finestra di dialogo Modifica comando .
  2. Modificare il comando dell'editor selezionato, quindi fare clic su OK per salvare le modifiche e chiudere la casella di dialogo. Il comando modificato viene visualizzato nell'elenco dei comandi editor.
4. Facoltativo. Per rimuovere un comando dall'elenco di comandi dell'editor, selezionare il comando che si desidera rimuovere e fare clic su Rimuovi. Il comando selezionato viene rimosso dall'elenco dei comandi dell'editor.
5. Per modificare l'ordine dei comandi nell'elenco dei comandi dell'editor, selezionare un comando che si desidera spostare, quindi fare clic su Sposta su o Sposta giù per modificarne la posizione all'interno dell'elenco dei comandi.
  I comandi vengono eseguiti nell'ordine in cui appaiono nell'elenco dei comandi dell'editor.
  Nota: Per i file in un sottoprogetto z/OS® UNIX, i comandi specificati nella pagina di preferenza HLASM Parser vengono eseguiti per primi, seguiti da qualsiasi comando applicabile impostato nella scheda HLASM della pagina di preferenza Editor Options.
Nella sezione Macro utente F1 Help Files , specificare un elenco dei file della guida della macro utente che memorizzano la mappatura della guida per le macro utente:
1. Fare clic su Aggiungi per aprire la finestra di dialogo Aggiungi posizione file della guida .
2. Eseguire una delle seguenti azioni:
  - Fare clic sul pulsante di opzione Utilizza un file di mappatura creato manualmente . Nel campo File di associazione , immettere il nome del file di aiuto della macro utente locale o remoto che si desidera utilizzare. È necessario specificare il nome utilizzando una lettera di unità completa o un percorso UNC. Ad esempio, \\HOSTNAME\MyFolder\my_macro_help.hlp. È inoltre possibile specificare il nome di questo file utilizzando le variabili di ambiente. Racchiudere i nomi delle variabili utilizzando il simbolo%. Per ricercare l'ubicazione del file della guida della macro utente da utilizzare, fare clic su Sfoglia.
  - Fare clic sul pulsante di opzione Genera indice da un indice della guida esistente . Nel campo Nome plug-in , immettere il nome del plug-in che contiene la propria guida personalizzata. Nel campo Nome file TOC , immettere il nome del file toc.xml creato per le macro personalizzate.
    Nota: l'attributo etichetta per ogni argomento nel file toc.xml viene utilizzato come nome macro e l'attributo href viene utilizzato come pagina della guida associata. Se un argomento nel file toc.xml ha un attributo label, ma nessun attributo href , viene ignorato. Se l'attributo etichetta contiene spazi, viene ignorato e non viene indicizzato. Si consiglia di specificare le etichette in maiuscolo poiché i nomi delle macro vengono convertiti in maiuscolo prima di qualsiasi confronto.
  - Fare clic su OK per chiudere la casella di dialogo.
  L'ubicazione del file della guida viene visualizzata nell'elenco dei file della guida della macro utente.
3. Ripetere questa procedura per ogni ulteriore file della guida della macro utente che si desidera aggiungere all'elenco di file della guida della macro utente.
  
  Suggerimento: questo elenco di file è cumulativo; ogni file della guida contenuto in questo elenco viene ricercato quando si cerca un nome macro. Se più di un file contiene lo stesso nome macro, viene utilizzato il nome macro nel primo file. Ad esempio, se nell'elenco sono presenti due file della guida e ciascun file contiene una corrispondenza tra il nome della macro MYMAC e una pagina della guida associata, viene utilizzata l'associazione contenuta nel primo file della guida. Se esistono più istanze di un nome macro all'interno dello stesso file di aiuto, viene utilizzata l'ultima ricorrenza del nome macro in tale file. Ad esempio, se un singolo file della guida contiene più istanze del nome della macro MYMAC, viene utilizzata l'ultima ricorrenza di MYMAC in tale file.
Nota: i file della guida della macro utente possono avere qualsiasi estensione di nome file.
Se si modifica il file della guida della macro utente e si desidera ricaricare il file per riflettere le modifiche, effettuare una delle seguenti azioni:
- Immettere il seguente comando in qualsiasi editor aperto utilizzando il file macro modificato:
  reloadUserHelpFile
- Fare clic con il tasto destro del mouse per aprire il menu a comparsa, quindi selezionare Ricarica macro utente F1 File della guida.
Nota: Per i file in un sottoprogetto z/OS UNIX, se i file di aiuto alle macro utente sono già specificati nella scheda HLASM della pagina di preferenze Editor Options, tali impostazioni sovrascrivono le impostazioni dei file di aiuto alle macro utente specificate nella pagina di preferenze HLASM Parser.
Nella sezione Commento automatico , effettuare le seguenti operazioni:
1. Selezionare la casella di spunta Aggiungi commento automatico alle righe modificate per specificare che si desidera aggiungere un commento automatico a ciascuna riga che si cambia durante la modifica di un file con l'editor LPEX z Systems ®.
  Quando viene richiamato il commento automatico, viene utilizzato il profilo lingua predefinito. Il profilo lingua predefinito è impostato nella pagina delle preferenze di commento automatico.
2. Nel campo Commento di base , immettere il commento che si desidera venga visualizzato su ogni riga che si modifica durante la modifica di un file con l'editor LPEX z Systems. Ad esempio, un numero di difetto.
  È possibile utilizzare le variabili di sostituzione a livello di sottoprogetto; le variabili di sostituzione a livello di file non sono supportate.
  
  Ad esempio, &N, dove la variabile utente &N rappresenta il nome di un sottoprogetto z/OS UNIX.
  
  Suggerimento: se il commento di base è impostato, ma il file non aggiunge un commento alle righe modificate, il commento di base potrebbe non soddisfare i criteri specificati nelle opzioni del profilo. È possibile utilizzare la pagina delle preferenze Commento automatico per visualizzare o modificare le opzioni del profilo di commento automatico.
Nota: Per i file di sottoprogetto di z/OS UNIX, se le impostazioni di autocommento sono già state specificate nella scheda HLASM della pagina di preferenze Editor Options, tali impostazioni sovrascrivono qualsiasi impostazione di autocommento specificata nella pagina di preferenze HLASM Parser.
Per specificare il file di macro che memorizza le definizioni di macro fornite da IBM®, nel campo File macro di base , fare clic su Sfoglia per passare all'ubicazione del file di macro oppure immettere il nome completo del file utilizzando una lettera di unità o un percorso UNC. È possibile utilizzare variabili di ambiente come %ENVVARS%\tpfhlasm.dat, dove %ENVVARS% punta all'ubicazione del file. È anche possibile specificare un membro di dataset partizionato o un dataset sequenziale.
Se si modifica il file della macro e si desidera ricaricare il file per riflettere le modifiche, immettere il comando reloadTPFMacrosFile nella riga comandi dell'editor o fare clic con il pulsante destro del mouse nell'editor e selezionare Ricarica file delle macro di base.
Per specificare un file di macro utente che memorizza le definizioni di macro utente:
1. Creare un file macro utente con qualsiasi estensione nome - file.
  È possibile utilizzare un file di macro utente per nascondere le macro fornite da IBM definite nel file di macro di base dal programma di analisi HLASM e per far riconoscere la propria sintassi di macro personalizzata.
2. Nel campo File macro utente , fare clic su Sfoglia per passare all'ubicazione del file macro oppure immettere il percorso completo del file, ad esempio \\HOSTNAME\MyFolder\my_macro_file.dat. È possibile utilizzare variabili di ambiente come %ENVVARS%\tpfhlasm.dat, dove %ENVVARS% punta all'ubicazione del file. È anche possibile specificare un membro di dataset partizionato o un dataset sequenziale.
Se si modifica il file della macro utente e si desidera ricaricare il file per riflettere le modifiche, immettere il comando reloadUserMacrosFile nella riga comandi dell'Editor o fare clic con il pulsante destro del mouse nell'editor e selezionare Ricarica file delle macro utente.
Nota: è possibile definire l'ubicazione dei file macro in due ubicazioni: in un gruppo di proprietà remoto associato a una risorsa o nella pagina delle preferenze Programma di analisi HLASM . Per definire i file macro per le risorse assembler locali, è necessario utilizzare la pagina delle preferenze Programma di analisi HLASM . Le definizioni dei file macro nei gruppi di propriet ... remoti hanno la precedenza sulle definizioni macro nella pagina delle preferenze HLASM Parser . Se una risorsa Assembler dispone di un gruppo di proprietà remoto associato, ma il file macro utente non è definito nel gruppo di proprietà, non viene utilizzato alcun file macro utente.
Per specificare il file dei colori delle istruzioni personalizzate che memorizza i dati relativi al modo in cui devono essere colorate le specifiche istruzioni nel programma di analisi HLASM, effettuare una delle seguenti azioni:
- Nel campo File di colori delle istruzioni personalizzate , immettere il nome del file di colori delle istruzioni personalizzate locali o remote che si desidera utilizzare. È possibile specificare il nome di questo file utilizzando le variabili di ambiente e il percorso UNC.
- Fare clic su Sfoglia per ricercare l'ubicazione del file di colori delle istruzioni personalizzate che si desidera utilizzare. Questo file deve avere un'estensione nome - file .xml .
Suggerimento: utilizzando il programma di analisi HLASM, è possibile impostare i colori per le istruzioni in base alle istruzioni. Se si desidera impostare i colori per le istruzioni in base al tipo di istruzione (ad esempio, l'istruzione della macchina), è possibile utilizzare la pagina delle preferenze Stili parser dell'editor LPEX. Per impostare la preferenza di colorazione per tipo di istruzione, nella finestra Preferenze , fare doppio clic sul nodo Editor LPEX per aprire l'elenco delle pagine delle preferenze dell'editor LPEX disponibili. Fare doppio clic su Programmi di analisi per aprire la pagina Programmi di analisi , quindi fare clic su Stili programma di analisi per aprire la pagina Stili programma di analisi .
Per utilizzare i colori definiti nel file Colore istruzione personalizzato, attivare la funzione di colorazione personalizzata per ogni file che utilizza il programma di analisi HLASM. È possibile attivare questa funzione utilizzando il comando setCustomColoring on .

Nota: Per i file in un sottoprogetto z/OS UNIX, se nella scheda HLASM della pagina di preferenze Editor Options è già specificato un file di colore di istruzione personalizzato, tale impostazione sovrascrive qualsiasi file di colore di istruzione personalizzato specificato nella pagina di preferenze HLASM Parser per i file.
Fare clic su Modifica per aprire la casella di dialogo Colori istruzioni personalizzate .
Modificare il file di istruzione del colore personalizzato selezionato. Consultare il collegamento riportato di seguito per i dettagli su come modificare i file di colore delle istruzioni personalizzate.
Specificare il livello CICS® che il parser deve utilizzare per l'analisi e l'assistente ai contenuti sulle istruzioni CICS integrate.
Fare clic su Applica per salvare le selezioni nella pagina delle preferenze. Le preferenze selezionate vengono applicate a tutti i file che utilizzano il programma di analisi HLASM.

Suggerimento: se si modificano le preferenze del parser HLASM, le opzioni dell'editor o le impostazioni del gruppo di proprietà o si aggiunge un file a un sottoprogetto z/OS UNIX o MVS e il file è già aperto in z Systems LPEX Editor, le modifiche non verranno visualizzate a meno che non si chiuda e riapra il file o si esegua il comando updateProfile per registrare le modifiche con il parser HLASM.