Conservazione dell'integrità dei file binari

L'integrazione Dependency Based Build (DBB) utilizza diverse impostazioni di preferenza e di creazione utente per garantire l'integrità dei file binari codificati EBCDIC durante il trasferimento al sistema remoto per un'operazione di generazione utente. Queste impostazioni offrono diverse opzioni per specificare le caratteristiche dei file binari codificati EBCDIC. Informazioni su come impostare Developer for z/OS® per un trasferimento corretto di file binari durante un'operazione di generazione utente.

Informazioni su questa attività

Quando strumenti quali Dependency Based Build e Engineering Workflow Management per z/OS copiano il codice sorgente tra un sistema host e un repository locale, i file devono essere convertiti da una codifica di caratteri a un'altra. Esistono alcune situazioni in cui i caratteri non si associano correttamente tra diverse codifiche di caratteri. Ad esempio, quando un carattere di nuova riga viene convertito in una nuova riga, i file trasferiti hanno ulteriori record vuoti rispetto al file originale. I file che contengono tali caratteri non roundtrippable vengono modificati e contrassegnati come binari. Per ulteriori informazioni su questo tipo di situazioni, vedere Gestione di caratteri non validi per roundtrippable in Migrazione di set di dati a git.

Per modificare o trasferire correttamente i file binari codificati EBCDIC al sistema remoto per un'operazione di generazione utente, l'integrazione Dependency Based Build richiede le seguenti informazioni sui file:

Il tipo di contenuto: testo o binario.
La codifica del file sul sistema remoto.
La lunghezza del record del file.

L'operazione di creazione utente Dependency Based Build può ottenere queste informazioni da diverse origini:

Può attraversare un progetto per ottenere informazioni sull'attributo del file.
Può ottenere informazioni sul tipo di contenuto del file e sulla codifica da un file di attributi Git specificato nella procedura guidata di configurazione della build utente o nella pagina delle preferenze Team > Git > Integrazione remota.
Limitazione: le informazioni sulla lunghezza del record per file binari migrati da Dependency Based Build non possono essere ottenute dal file di attributi Git . Quando Dependency Based Build migra file non roundtrippable, rimuove le informazioni sulla lunghezza del record dai file. Questi dati devono essere forniti manualmente in modo che i file possano essere modificati in Developer for z/OS.
Può ottenere informazioni sulla lunghezza predefinita del record per un modello di nome file specificato nella pagina delle preferenze Team > Integrazione remota.
Può ottenere le informazioni sull'attributo del file dalle proprietà del file. Queste proprietà possono essere specificate per ogni file o ereditate dalla cartella o dal progetto in cui si trova il file.

Utilizzare la seguente procedura per impostare queste opzioni e imparare come funzionano insieme per fornire attributi file all'operazione di build utente.

Procedura

Nota: le funzioni Developer for z/OS e DBB sono disponibili solo per i repository Git importati nei progetti z/OS e accessibili nella vista Progetti z/OS . Se non hai ancora creato un progetto z/OS dal contenuto dell'archivio Git, segui le istruzioni in Aggiungere un archivio Git alla vista Progetti z/OS.

Per impostare Developer for z/OS per ottenere informazioni sull'attributo file per i trasferimenti di file di build utente:

Impostare le preferenze che determinano il modo in cui l'operazione di generazione utente stabilisce la lunghezza record dei trasferimenti file binari:
1. Apri la finestra Preferenze e vai a Team > Integrazione remota.
  Le impostazioni predefinite per la lunghezza record del file binario assegnano una lunghezza record di 80 a tutti i tipi di file. Per aggiungere voci per tipi di file specifici:
  1. Fare clic sul simbolo * nella cella Modello e modificare il valore in un altro modello di nome file, ad esempio *.groovy.
  2. Fare clic su 80 nella cella Lunghezza record e modificare il valore in un numero appropriato per il tipo di file.
  3. Fare clic su Applica.
  4. Fare clic sulla seconda riga nella tabella, quindi fare clic su Aggiungi. Una nuova riga con Modello * e Lunghezza record 80 viene aggiunta alla tabella.
    Suggerimento: il pulsante Aggiungi non è abilitato finché non si fa clic su Applica e quindi su una nuova riga.
  5. Modificare la nuova riga come necessario, quindi fare clic su Applica, fare clic sulla terza riga e selezionare Aggiungi.
  6. Continuare questa procedura fino a quando la tabella non contiene tutti i modelli di file e le lunghezze di record necessarie. L'ultima riga della tabella contiene sempre Modello * e Lunghezza record 80.
  Il risultato di questa procedura è quello di assegnare le lunghezze record specificate ai modelli di file aggiunti e quindi assegnare la lunghezza record 80 a tutti i restanti file binari che non corrispondono a nessuno dei modelli di file definiti.
2. Utilizzare questa tabella per definire le lunghezze di record predefinite per i modelli di nome file sul sistema locale. Per impostazione predefinita, tutti i file binari locali hanno una lunghezza record di 80. Fare clic sui pulsanti Aggiungi, Rimuovi, Sue Giù per modificare e riordinare le righe della tabella.
3. Selezionare l'opzione Abilita specifica file locale delle informazioni di attributo per abilitare la sostituzione locale delle lunghezze record predefinite. Quando questa opzione è abilitata, è possibile utilizzare la pagina Dettagli del contenuto locale della finestra Proprietà del file per impostare il tipo di contenuto del file (testo o binario), la codifica remota e la lunghezza del record per i file binari.
Impostare gli attributi di trasferimento file persistenti per i file locali nella pagina Dettagli contenuto locale :
1. Nella vista z/OS Progetti , fare clic con il tasto destro del mouse su un nome file e selezionare Proprietà
2. Selezionare Local Content Details dal pannello di navigazione.
3. Per ogni attributo, è possibile utilizzare il valore predefinito, selezionare un valore specifico (Altro) oppure derivare il valore da una delle seguenti origini:
  - Valore predefinito del sistema: il file eredita gli attributi dai valori predefiniti del sistema.
  - Attributo del team: il tipo di contenuto e la codifica remota sono determinati dalle informazioni sull'attributo del team, come le informazioni fornite da Git o Engineering Workflow Management.
  - Tipo di file: il tipo di contenuto è determinato facendo corrispondere un tipo di file definito nella pagina Preferenze dell' Sistemi remoti > File .
  - Preferenza spazio di lavoro: questa opzione è valida solo per la lunghezza record di file binario. Quando si seleziona questa opzione, il file binario eredita la lunghezza del record dalla tabella nella pagina Preferenze dell' Squadra > Integrazione remota .
  - Impostazione progetto: questa opzione si applica solo alla lunghezza record del file binario. Quando questa opzione è selezionata, il file binario eredita la lunghezza del record dalla pagina Dettagli contenuto locale della finestra Proprietà del progetto. Per passare a questa pagina, fare clic con il tasto destro del mouse su un progetto, selezionare Proprietà, quindi selezionare Dettagli contenuto locale nel riquadro di navigazione.
Impostare le preferenze che determinano il modo in cui il file di attributi Git è composto per i trasferimenti file di creazione utente.
Questa procedura determina in che modo l'opzione Configura build utente User Build Utilizza il project traversal per comporre gli attributi viene implementata per una build utente.
1. Aprire la finestra Preferenze e andare su Team > Git > Integrazione remota.
2. Nel campo File attributi , specificare il nome del file di attributi Git che deve essere composto da Project Traversal.
3. Facoltativo: selezionare queste opzioni per l'elaborazione del file di attributi Git creato:
  
  Abilita scansione del file di attributi per le modifiche: quando questa opzione è selezionata, il prodotto controlla il file di attributi per rilevare le modifiche ai file e le informazioni sulla codifica dei file e sul tipo di contenuto nel repository Git . Quando vengono rilevate delle modifiche, il prodotto aggiorna le proprietà persistenti dei file locali con queste modifiche.
  
  Gli attributi di codifica locale e tipo di contenuto hanno la precedenza sugli attributi scansionati: quando questa opzione è selezionata, qualsiasi informazione di codifica e tipo di contenuto specificata nella pagina Dettagli contenuto locale della finestra Proprietà del file locale ha la precedenza sulle impostazioni rilevate nel file di attributi.
Per visualizzare gli attributi file per i file trasferiti quando si configura una build utente, selezionare l'opzione Mostra informazioni sul trasferimento file nella procedura guidata Configura User Build . Per ulteriori informazioni su questa procedura guidata, vedere Utilizzo della procedura guidata di creazione utente ( zAppBuild ).