Codificatore EBCDIC

Un codificatore EBCDIC traduce il testo quotidiano nella code page 037 dei mainframe IBM, il set di caratteri a un byte classico di Stati Uniti e Canada ancora presente in copybook COBOL, dump VSAM e payload MQ. Incolli testo semplice e scelga to_ebcdic per ricevere byte EBCDIC esadecimali separati da spazi, oppure incolli hex e scelga to_ascii per recuperare caratteri leggibili. Studenti, ingegneri di migrazione e team di supporto ottengono lo stesso JSON deterministico dall’esecutore gratuito del browser e dall’API prepagata.

Come si relazionano ASCII ed EBCDIC code page 037 e perché contano i non mappati

Se è maggiore, il carattere viene omesso dal flusso di byte e registrato in unmapped con indice nella stringa e code_point così gli operatori possono eliminare o traslitterare deliberatamente. Token hex non validi o lunghezza continua dispari sollevano invalid_input invece di inventare padding.

Come chiamare l’API e cosa contiene la risposta

Invii un corpo JSON con il campo stringa obbligatorio text (alias input, value e data) e un mode opzionale to_ebcdic o to_ascii. La modalità predefinita è to_ebcdic: ogni carattere mappabile diventa un byte EBCDIC CP037 in hex minuscolo, unito con spazi in result e ebcdic_hex. La modalità to_ascii tratta text come hex EBCDIC—coppie separate da spazi, virgole, punti e virgola, pipe, o una stringa continua da zero a nove e A a F di lunghezza pari—e restituisce la stringa recuperata in result e text. La lunghezza dell’input è limitata a centomila caratteri così una sola richiesta non esaurisce la memoria del Worker. In successo entrambe le modalità includono mode, code_page impostato alla stringa 037, input, result, bytes come interi da zero a duecentocinquantacinque, byte_count, char_count, mapped_count, unmapped_count, unmapped come array di oggetti con index, char e code_point, più un breve messaggio in inglese. La codifica espone anche ebcdic_hex uguale a result; la decodifica normalizza ebcdic_hex in coppie separate da spazi anche se ha incollato hex continuo. Validazione fallita—text assente, text non stringa, input troppo grande, mode sconosciuto, hex vuoto, hex continuo di lunghezza dispari o token che non sia esattamente due cifre esadecimali—restituisce invalid_input e non viene mai addebitata. Il prezzo è un fisso $0.002 per richiesta riuscita con unità item.

Consigli pratici, controlli di migrazione e strumenti correlati

I controlli andata e ritorno sono lo smoke test più rapido: codifichi Hello, confermi che il primo byte è C8 per H e che lo spazio sarebbe 40, poi decodifichi l’hex e confermi la stringa originale. Preferisca questa capacità quando l’intento di ricerca è testo ASCII o latino rispetto all’hex della IBM code page 037; usi un codificatore di byte UTF-8 per sequenze multibyte moderne e strumenti Base64 quando l’obiettivo è il framing di trasporto e non la traduzione del set di caratteri. Nell’insegnamento, mostri la stessa lettera come ASCII decimale, come hex CP037 e come l’interpretazione errata sotto ISO-8859-1 così gli studenti vedono perché le integrazioni mainframe richiedono ancora un passo EBCDIC esplicito. Preferisca to_ascii quando ha già copiato hex da un dump, una traccia CICS o un editor hex e vuole recuperare i glifi. Includa di proposito un emoji o un carattere CJK accanto ad ASCII semplice per affermare che unmapped_count sale e che il flusso EBCDIC contiene solo il sottoinsieme mappabile—gli script di migrazione devono fallire in chiusura quando unmapped_count è diverso da zero se il sistema di destinazione non può memorizzare quei caratteri. Mantenga i payload sotto il limite di caratteri pubblicato; dataset binari multi-megabyte restano offline con iconv o utilità di dataset. Questo strumento non è un convertitore generale della famiglia EBCDIC: le code page 500, 1047 e 1140 differiscono su simboli di valuta ed euro, quindi non assuma che l’hex sia portabile tra quei CCSID. Le attività con invalid_input non consumano il saldo prepagato, il che mantiene economici gli script esplorativi quando gli studenti incollano gruppi hex incompleti.